Facebook Auth

1. Create a Facebook App

1. Go to Meta for Developers and click My Apps → Create App
2. In Add use case section select Authenticate and request data from users with Facebook Login
3. Fill in the the details and click Create App
4. On App Dashboard Click "Customize the Authenticate and request data from users with Facebook Login use case"
5. Click + Add next to email
6. In the left sidebar, Go to App Settings → Basic:
   • Fill the details (icon
   • Privacy policy URL https://yourdomain.com/legal/privacy
   • Terms of Service URL https://yourdomain.com/legal/terms
   • User data deletion https://yourdomain.com/legal/terms
   • Pick a Category
   • Copy the App ID — this is your APP_ID
   • Copy the App Secret — this is your APP_SECRET 7 Go to App Settings → Advanced:
   • Authorize callback URL https://yourdomain.com/api/auth/callback/facebook

2. Set Environment Variables

# .env.local
FACEBOOK_CLIENT_ID=your-app-id
FACEBOOK_CLIENT_SECRET=your-app-secret

3. Enable in Config

In src/appConfig.ts set:

facebook: { enabled: true },

4. Test

1. Run pnpm dev
2. Navigate to /auth/sign-in
3. A Sign in with Facebook button will appear

While your app is in Development mode, only users listed as app testers or developers can sign in. Switch to Live for public access.

Production Checklist

• Switch the app from Development to Live mode in the app dashboard
• Make sure the email and public_profile permissions are approved (they are by default for basic use)

Troubleshooting

• No email returned — Facebook may omit email for phone-only accounts or when the user hasn't granted email permission. This is a Facebook limitation.
• Invalid OAuth redirect URI — the redirect URI must exactly match what's configured in Facebook Login settings
• No Facebook button — check FACEBOOK_CLIENT_ID and FACEBOOK_CLIENT_SECRET are set and facebook.enabled is true