Oauth for Newbies

Maybe consider unpacking the OAuth setup a bit earlier in the instructions for unknowledgeable users. The auth wont work straight out of the box and therefore the UX is broken, users donʻt the initial responses form the LLM to validate the system works.

I followed these instructions (Opus 4.6) and they worked fine

Here's how to create the OAuth app:

1. Go to your NNNNNN team settings: https://vercel.com/nnnn/~/settings
2. Scroll down to Apps and click Create
3. Name it something like nnnn and save
4. On the app's manage page: - Generate a client secret (copy it immediately) - Add Authorization Callback URLs:
   • http://localhost:3000/api/auth/oauth2/callback/vercel
   • https:///api/auth/oauth2/callback/vercel - Under Permissions, enable: openid, email, profile, offline_access

Important: This project uses Better Auth's genericOAuth plugin, so the callback URL path is /api/auth/oauth2/callback/vercel (not the default /api/auth/callback from Vercel's docs).

Once you have the Client ID and Client Secret add them to .env.local along with BETTER_AUTH_URL.

Sources:

• https://vercel.com/docs/sign-in-with-vercel/getting-started
• https://vercel.com/docs/sign-in-with-vercel/manage-from-dashboard