# nextauthjs/next-auth architecture

> Architecture diagram of the GitHub repository nextauthjs/next-auth, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nextauthjs/next-auth
- Repository: https://github.com/nextauthjs/next-auth

## Overview

Auth.js is a full-stack authentication toolkit: framework integrations expose authentication endpoints and client helpers, while the core handles sign-in and session operations. Its provider catalog supports OAuth/OIDC, email/passwordless and WebAuthn; applications may use database-backed adapters or stateless sessions. The graph preserves the major documented capabilities, but several core and framework modules were not sampled, so their internal call sequence is not asserted.

Main entry points: [`packages/core/src/index.ts`](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/index.ts) (Auth engine), [`packages/adapter-d1/src/index.ts`](https://github.com/nextauthjs/next-auth/blob/main/packages/adapter-d1/src/index.ts) (Cloudflare D1 adapter), [`packages/next-auth/src`](https://github.com/nextauthjs/next-auth/tree/main/packages/next-auth/src) (Next.js integration), [`packages/frameworks-express/src`](https://github.com/nextauthjs/next-auth/tree/main/packages/frameworks-express/src) (Framework entry points)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frameworks["Framework integrations"]
  node_frameworks["Framework entry points"]
  node_next["Next.js integration"]
  node_svelte["SvelteKit integration"]
  node_qwik["Qwik integration"]
end

subgraph group_engine["Authentication core"]
  node_core["Auth engine<br/>[index.ts]"]
  node_actions["Auth actions"]
  node_session["Session and JWT<br/>[session.ts]"]
  node_oauth["OAuth/OIDC flow<br/>[oauth.ts]"]
  node_webauthn["WebAuthn client<br/>[webauthn.ts]"]
end

subgraph group_providers["Sign-in methods"]
  node_provider_catalog["Provider catalog"]
  node_email["Email sign-in<br/>[email.ts]"]
  node_passkey["Passkey provider<br/>[passkey.ts]"]
end

subgraph group_storage["Persistence adapters"]
  node_adapter_api["Adapter contract<br/>[adapter.ts]"]
  node_d1["Cloudflare D1 adapter<br/>[index.ts]"]
  node_d1_queries["D1 queries<br/>[queries.ts]"]
  node_d1_migrations["D1 migrations<br/>[migrations.ts]"]
  node_db_adapters["Database adapters"]
end

node_user(("Application user"))
node_database[("Application database")]

node_user -->|"uses"| node_frameworks
node_frameworks -->|"dispatches auth"| node_core
node_next -->|"uses core"| node_core
node_svelte -->|"uses core"| node_core
node_core -.->|"handles auth actions"| node_actions
node_core -->|"supports OAuth/OIDC"| node_oauth
node_core -->|"offers providers"| node_provider_catalog
node_core -->|"supports passwordless"| node_email
node_core -->|"supports WebAuthn"| node_passkey
node_next -->|"exposes passkey flow"| node_webauthn
node_core -->|"manages sessions"| node_session
node_core -->|"defines adapter contract"| node_adapter_api
node_d1 -->|"uses queries"| node_d1_queries
node_d1 -->|"uses migrations"| node_d1_migrations
node_d1 -->|"reads/writes"| node_database
node_db_adapters -->|"persist auth data"| node_database
node_adapter_api -->|"integrates with"| node_core

click node_frameworks "https://github.com/nextauthjs/next-auth/tree/main/packages/frameworks-express/src"
click node_next "https://github.com/nextauthjs/next-auth/tree/main/packages/next-auth/src"
click node_svelte "https://github.com/nextauthjs/next-auth/tree/main/packages/frameworks-sveltekit/src"
click node_qwik "https://github.com/nextauthjs/next-auth/tree/main/packages/frameworks-qwik/src"
click node_core "https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/index.ts"
click node_actions "https://github.com/nextauthjs/next-auth/tree/main/packages/core/src/lib/actions"
click node_session "https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/lib/actions/session.ts"
click node_oauth "https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/oauth.ts"
click node_webauthn "https://github.com/nextauthjs/next-auth/blob/main/packages/next-auth/src/webauthn.ts"
click node_provider_catalog "https://github.com/nextauthjs/next-auth/tree/main/packages/core/src/providers"
click node_email "https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/email.ts"
click node_passkey "https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/passkey.ts"
click node_adapter_api "https://github.com/nextauthjs/next-auth/blob/main/packages/utils/adapter.ts"
click node_d1 "https://github.com/nextauthjs/next-auth/blob/main/packages/adapter-d1/src/index.ts"
click node_d1_queries "https://github.com/nextauthjs/next-auth/blob/main/packages/adapter-d1/src/queries.ts"
click node_d1_migrations "https://github.com/nextauthjs/next-auth/blob/main/packages/adapter-d1/src/migrations.ts"
click node_db_adapters "https://github.com/nextauthjs/next-auth/tree/main/packages"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frameworks,node_next,node_svelte,node_qwik,node_user toneBlue
class node_core,node_actions,node_session,node_oauth,node_webauthn,node_database toneAmber
class node_provider_catalog,node_email,node_passkey toneMint
class node_adapter_api,node_d1,node_d1_queries,node_d1_migrations,node_db_adapters toneRose
```

## Components

### Framework integrations

- [Framework entry points](https://github.com/nextauthjs/next-auth/tree/main/packages/frameworks-express/src): `packages/frameworks-express/src`
- [Next.js integration](https://github.com/nextauthjs/next-auth/tree/main/packages/next-auth/src): `packages/next-auth/src`
- [SvelteKit integration](https://github.com/nextauthjs/next-auth/tree/main/packages/frameworks-sveltekit/src): `packages/frameworks-sveltekit/src`
- [Qwik integration](https://github.com/nextauthjs/next-auth/tree/main/packages/frameworks-qwik/src): `packages/frameworks-qwik/src`

### Authentication core

- [Auth engine](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/index.ts): `packages/core/src/index.ts`
- [Auth actions](https://github.com/nextauthjs/next-auth/tree/main/packages/core/src/lib/actions): `packages/core/src/lib/actions`
- [Session and JWT](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/lib/actions/session.ts): `packages/core/src/lib/actions/session.ts`
- [OAuth/OIDC flow](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/oauth.ts): `packages/core/src/providers/oauth.ts`
- [WebAuthn client](https://github.com/nextauthjs/next-auth/blob/main/packages/next-auth/src/webauthn.ts): `packages/next-auth/src/webauthn.ts`

### Sign-in methods

- [Provider catalog](https://github.com/nextauthjs/next-auth/tree/main/packages/core/src/providers): `packages/core/src/providers`
- [Email sign-in](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/email.ts): `packages/core/src/providers/email.ts`
- [Passkey provider](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/passkey.ts): `packages/core/src/providers/passkey.ts`

### Persistence adapters

- [Adapter contract](https://github.com/nextauthjs/next-auth/blob/main/packages/utils/adapter.ts): `packages/utils/adapter.ts`
- [Cloudflare D1 adapter](https://github.com/nextauthjs/next-auth/blob/main/packages/adapter-d1/src/index.ts): `packages/adapter-d1/src/index.ts`
- [D1 queries](https://github.com/nextauthjs/next-auth/blob/main/packages/adapter-d1/src/queries.ts): `packages/adapter-d1/src/queries.ts`
- [D1 migrations](https://github.com/nextauthjs/next-auth/blob/main/packages/adapter-d1/src/migrations.ts): `packages/adapter-d1/src/migrations.ts`
- [Database adapters](https://github.com/nextauthjs/next-auth/tree/main/packages): `packages`

### Other components

- **Application user**
- **Application database**

## Connections

- Application user → Framework entry points: uses
- Framework entry points → Auth engine: dispatches auth
- Next.js integration → Auth engine: uses core (evidence: `packages/next-auth/src/lib/client.ts`)
- SvelteKit integration → Auth engine: uses core (evidence: `packages/frameworks-sveltekit/src/lib/client.ts`)
- Auth engine → Auth actions: handles auth actions
- Auth engine → OAuth/OIDC flow: supports OAuth/OIDC (evidence: `packages/core/src/providers/oauth.ts`)
- Auth engine → Provider catalog: offers providers (evidence: `packages/core/src/providers/oauth.ts`)
- Auth engine → Email sign-in: supports passwordless
- Auth engine → Passkey provider: supports WebAuthn
- Next.js integration → WebAuthn client: exposes passkey flow (evidence: `packages/next-auth/src/webauthn.ts`)
- Auth engine → Session and JWT: manages sessions
- Auth engine → Adapter contract: defines adapter contract (evidence: `packages/utils/adapter.ts`)
- Cloudflare D1 adapter → D1 queries: uses queries (evidence: `packages/adapter-d1/src/index.ts`)
- Cloudflare D1 adapter → D1 migrations: uses migrations (evidence: `packages/adapter-d1/src/index.ts`)
- Cloudflare D1 adapter → Application database: reads/writes (evidence: `packages/adapter-d1/src/index.ts`)
- Database adapters → Application database: persist auth data
- Adapter contract → Auth engine: integrates with (evidence: `packages/utils/adapter.ts`)
