Common errors

The errors you’re most likely to hit, with fixes.

Auth errors

'Not signed in' on every page

Auth context isn’t reaching the page. Check that the route is wrapped in the auth-protected layout. If using OAuth, verify the redirect URI matches your provider config exactly.

Sign-in fails silently

Check the browser console and Convex logs. Often a typo in the OAuth client secret or a wrong redirect URL.

'Email already exists'

A user with that email is already registered (perhaps via a different OAuth provider). Sign in with the original method, then link the new provider.

Type errors

Type 'X' is not assignable to type 'Y'

Schema mismatch between code and the Convex schema. Re-check the schema validators; the agent’s auto-correct usually handles this in 1-2 retries.

Cannot find module

Import path is wrong or the file doesn’t exist. Cmd+P / Ctrl+P to verify.

Convex errors

'Function not found'

The Convex function name is wrong, or the file hasn’t been deployed yet. Wait a few seconds; refresh.

'Document size exceeds 1 MB'

A field on a row is too large. Split into multiple documents or use file storage for large blobs.

Integration errors

Stripe: 'No signatures found matching the expected signature'

The webhook signing secret is wrong. Re-copy from Stripe → Webhooks → [endpoint] → Signing secret.

OpenAI: 'You exceeded your current quota'

Add credit at platform.openai.com/billing.

Resend: 'Domain is not verified'

Use [e-mail] for testing, or verify your domain in Resend.

Related

Build failures

Type errors, build pipeline.

Integration problems

Per-integration issues.

Debugging workflow

When the issue isn’t on this list.