convex-nextjs-dual-environment-secrets

What problem does it solve?

Addresses cross-environment secret synchronization between Next.js and Convex to prevent 'Unauthorized' errors in mutations and webhook handlers by ensuring INTERNAL_API_SECRET and related secrets exist in both environments.

Core Features & Use Cases

• Cross-env secret synchronization ensures Convex and Next.js share identical secrets across environments.
• Error diagnosis and verification help identify Unauthorized errors caused by missing or mismatched secrets in Convex or Next.js runtime.
• Deployment-time validation guides applying secret changes to both Next.js (.env.local) and Convex environment variables.
• Use Case: When a Convex mutation or webhook returns Unauthorized, fix by aligning secrets.

Quick Start

• Add INTERNAL_API_SECRET to Next.js .env.local and mirror the same value in Convex environment variables.
• Redeploy or refresh both environments, then trigger a small test mutation to verify authentication succeeds.