Problem: Production Clerk setups need CLERK_WEBHOOK_SECRET to sync user create/delete events to Supabase, but it is absent from .env.example, the README, and SUPABASE_CLERK_SETUP.md, so first-time users silently miss it.
What to do:
- Add
CLERK_WEBHOOK_SECRET=your_clerk_webhook_secret_here (with a comment) to .env.example.
- Add a short "Webhook Setup" subsection to
SUPABASE_CLERK_SETUP.md: where to find the secret in the Clerk dashboard and which events to listen for (user.created, user.deleted).
Acceptance: .env.example documents the variable; the setup doc explains webhook setup; npm run build passes.
Good first issue — documentation / DX.
Problem: Production Clerk setups need
CLERK_WEBHOOK_SECRETto sync user create/delete events to Supabase, but it is absent from.env.example, the README, andSUPABASE_CLERK_SETUP.md, so first-time users silently miss it.What to do:
CLERK_WEBHOOK_SECRET=your_clerk_webhook_secret_here(with a comment) to.env.example.SUPABASE_CLERK_SETUP.md: where to find the secret in the Clerk dashboard and which events to listen for (user.created,user.deleted).Acceptance:
.env.exampledocuments the variable; the setup doc explains webhook setup;npm run buildpasses.Good first issue — documentation / DX.