Twitter (X) Login Setup Guide for Mobile App

This guide will help you set up Twitter (X) login in your MartFury mobile app.

Prerequisites

1. A Twitter Developer Account
2. A Twitter App created in the Twitter Developer Portal
3. Basic knowledge of mobile app development

Step 1: Create a Twitter Developer Account

1. Go to Twitter Developer Portal
2. Sign in with your Twitter account
3. Apply for a developer account if you haven't already

Step 2: Create a Twitter App

1. In the Twitter Developer Portal, click "Create Project"
2. Fill in your project details
3. Select "Read and Write" permissions
4. Create an app within your project
5. Note down your API Key (Consumer Key) and API Secret Key (Consumer Secret)

Step 3: Configure Twitter App Settings

Critical Configuration

The MartFury app uses OAuth 1.0a (not OAuth 2.0). Incorrect settings will cause login failures with error code 302.

1. Go to your app's settings in the Twitter Developer Portal

2. Navigate to "User authentication settings" and click "Edit"

3. Configure the following settings exactly:

   Setting	Required Value
   App permissions	Read and write
   Type of App	Native App
   App info > Client type	Public client

4. Under "App info", add the callback URL:

   martfury://twitter-auth

5. Make sure OAuth 1.0a is enabled (check under "Keys and tokens" tab)

6. Save your changes

Common Mistakes That Cause Error 302

• Setting "Type of App" to "Web App, Automated App or Bot" instead of "Native App"
• Setting "Client type" to "Confidential client" instead of "Public client"
• Using OAuth 2.0 only without enabling OAuth 1.0a
• Callback URL mismatch (must be exactly martfury://twitter-auth)

Step 4: Configure Your Mobile App

Environment Variables

Create or update your .env file with the following variables:

TWITTER_CONSUMER_KEY=your_twitter_consumer_key
TWITTER_CONSUMER_SECRET=your_twitter_consumer_secret
TWITTER_REDIRECT_URI=martfury://twitter-auth

Replace your_twitter_consumer_key and your_twitter_consumer_secret with your actual Twitter API credentials.

iOS Configuration

The Twitter URL scheme is already configured in your Info.plist. Verify it contains the martfury scheme:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>martfury</string>
        </array>
    </dict>
</array>

Android Configuration

The Twitter configuration is already set up in your AndroidManifest.xml. Verify it contains:

1. The OAuthActivity (for handling Twitter's OAuth flow):

<activity
    android:name="com.twitter.sdk.android.core.identity.OAuthActivity"
    android:theme="@android:style/Theme.Translucent.NoTitleBar" />

2. The intent-filter in your MainActivity (for handling the callback):

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="martfury" />
</intent-filter>

:::note The app reads Twitter credentials from the .env file, not from AndroidManifest meta-data tags. You do NOT need to add CONSUMER_KEY or CONSUMER_SECRET meta-data to AndroidManifest. :::

Step 5: Testing the Integration

1. Run your app
2. Go to the login screen
3. Tap the X (Twitter) login button
4. Complete the Twitter authentication flow
5. Verify that you're redirected back to your app

Troubleshooting

Common Issues

1. Error 302 - "An error occurred (302)"

This is the most common error and is caused by incorrect Twitter Developer Portal settings.

Solution: Go to Twitter Developer Portal → Your App → User authentication settings → Edit, and verify:

Setting	Must Be
Type of App	Native App (NOT "Web App, Automated App or Bot")
Client type	Public client (NOT "Confidential client")
OAuth 1.0a	Enabled
Callback URL	martfury://twitter-auth

2. Login fails with "Invalid callback URL"

• Verify that the callback URL in Twitter Developer Portal matches exactly: martfury://twitter-auth
• Check that the URL scheme martfury is properly configured in both iOS (Info.plist) and Android (AndroidManifest.xml)
• Make sure your .env file has: TWITTER_REDIRECT_URI=martfury://twitter-auth

3. App crashes on Twitter login

• Verify that your Twitter API credentials are correct in .env
• Check that ENABLE_TWITTER_SIGN_IN=true in your .env file
• Ensure you have an active internet connection
• Check that OAuth 1.0a is enabled in Twitter Developer Portal

4. Twitter button not appearing

• Verify ENABLE_TWITTER_SIGN_IN=true in your .env file
• Verify TWITTER_CONSUMER_KEY and TWITTER_CONSUMER_SECRET are set
• Restart the app completely (hot reload does not reload .env changes)

Getting Help

If you encounter any issues:

1. Check the Twitter Developer Documentation
2. Review the twitter_login package documentation
3. Check your app's logs for detailed error messages

Security Considerations

1. Never commit your Twitter API credentials to version control
2. Always use environment variables for sensitive data
3. Implement proper error handling and user feedback

Additional Resources

• Twitter Developer Portal
• Twitter OAuth 1.0a Documentation
• twitter_login Package