Environment Settings

Required Environment Variables

You need to configure environment variables across three locations:

backend/.env.local

CONVEX_DEPLOYMENT=dev:your-deployment-name-123
CLERK_SECRET_KEY=sk_test_your_clerk_secret_key_here

apps/web/.env.local

NEXT_PUBLIC_CONVEX_URL=https://your-convex-deployment.convex.cloud
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_your_clerk_publishable_key_here

apps/mobile/.env.local

EXPO_PUBLIC_CONVEX_URL=https://your-convex-deployment.convex.cloud
EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_your_clerk_publishable_key_here

Getting Your Values

Convex URLs

1. Run bun run predev to create your deployment
2. Copy the deployment URL from the Convex dashboard
3. Use the deployment name (e.g., dev:name-123) for the backend
4. Use the full URL (e.g., https://name.convex.cloud) for frontend apps

Clerk Keys

1. Create a Clerk application at clerk.com
2. Get your Publishable Key (pk_test_...) from the dashboard
3. Get your Secret Key (sk_test_...) from API Keys section
4. Configure Clerk in Convex dashboard: Settings → Authentication

Development vs Production

Security

• Never commit .env.local files to version control
• Use different keys for development and production
• Rotate keys regularly