Clerk dev vs production: test keys, accountless CLI apps, and the production checklist

TL;DR

Unclaimed apps and temporary keys are not production-ready, per Clerk's own docs. - Before production, claim the app, then run the production deploy flow (npx clerk@latest deploy) and switch env vars to the production key pair.

Steps

1. Clerk issues separate publishable/secret key pairs per instance environment: pk_test/sk_test for development, pk_live/sk_live for production. The frontend and backend keys must come from the same environment. Mixing a test publishable key with a live secret key (or vice versa) fails in confusing ways.
2. npx clerk@latest init can provision a claimable application with temporary development keys without a Clerk account. That is great for scaffolding, but:
3. - Production keys in the host's env, never in the repo. NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY (or the bundler equivalent) is public by design; CLERK_SECRET_KEY never leaves the server.

• Production webhook endpoints recreated against the production URL, with the production signing secret in env.
• Authorized parties / allowed origins updated to the production domains.
• If you customized session token claims or JWT templates in dev, confirm the same configuration exists on the production instance; token verification failures after launch are often dev-only config.
• Run npx clerk@latest doctor as a final check; it verifies the setup end to end.

When to use

You are seeing this: Clerk issues separate publishable/secret key pairs per instance environment: pk\test/sk\test for development, pk\live/sk\live for production. Use this skill when you run into "Clerk dev vs production: test keys, accountless CLI apps, and the production checklist".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Clerk's React quickstart documents the accountless init flow, the claim requirement, and the production deploy step; the syncing guide covers production webhook endpoints and secrets. Verified live at https://clerk.com/docs/react/getting-started/quickstart.md and https://clerk.com/docs/guides/development/webhooks/syncing.md on 2026-09-26.