Skip to main content

convex.config

For AI agents: see llms.txt for the complete documentation index. Markdown versions are available by adding .md to a page URL or requesting Accept: text/markdown.

Variables​

default​

const default: ComponentDefinition<any, {
}>;

The core auth component.

Owns session lifetimes (sessions: refresh tokens, rotation, expiry). The mapping from a provider account to an app user lives in the component of each sign-in method, not here.

Access tokens are signed with the deployment's own key (ctx.auth.signJwt), so the component carries no signing material of its own. The public keys live at ${CONVEX_CLOUD_URL}/.well-known/jwks.json, and tokens minted here carry iss = ${CONVEX_CLOUD_URL}/components/auth.

It does NOT know about any specific sign-in method. Methods hand it identity claims (see ../lib/types) and the core turns that into a session + JWT.

Apps install it from @convex-dev/auth/convex.config.js.