feat(nuxt): Add support for keyless mode by wobsoriano · Pull Request #7844 · clerk/javascript

wobsoriano · 2026-02-13T18:05:48Z

Description

Last SDK to have keyless but not the least 😄

Add keyless mode support to the Nuxt SDK, allowing developers to use Clerk without manually configuring API keys during development.

Also simplifies the keyless service initialization in @clerk/astro and @clerk/react-router by replacing the async promise-based pattern with a simpler lazy singleton (consistent with other SDKs like Next.js).

Changes

@clerk/nuxt: Add keyless mode (server middleware, plugin, feature flags, file storage)
@clerk/nuxt: Move apiUrl/apiVersion to private runtime config (server-only, matching Next.js)
@clerk/astro: Simplify keyless service initialization
@clerk/react-router: Simplify keyless service initialization
Integration tests: Add Nuxt keyless E2E tests, bump template to Nuxt 4.4.2

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

changeset-bot · 2026-02-13T18:05:53Z

🦋 Changeset detected

Latest commit: c37d62c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@clerk/nuxt	Minor
@clerk/astro	Patch
@clerk/react-router	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-02-13T18:05:53Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Skipped		Apr 9, 2026 6:48pm

coderabbitai · 2026-02-13T18:08:49Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

📝 Walkthrough

Walkthrough

Adds a keyless quickstart for Nuxt and a changeset declaring a minor release. Introduces Playwright integration tests for Nuxt keyless mode. Adds Nuxt server keyless modules: file storage, lazy-initialized service, utilities, middleware resolution, a ClerkKeylessContext type, and a feature-flag helper. Updates Nuxt plugin to pass keyless context. Simplifies keyless initialization in Astro and React Router packages to a synchronous lazy singleton and removes resetKeylessService. Updates Nuxt template dependency versions.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 20.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: adding keyless mode support for Nuxt. It is concise, specific, and directly reflects the primary objective of the pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Introduce Keyless quickstart for Nuxt, enabling use of the Clerk SDK without manual key setup.

pkg-pr-new · 2026-02-13T18:16:18Z

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7844

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7844

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7844

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7844

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7844

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7844

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@7844

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7844

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7844

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7844

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@7844

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7844

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7844

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7844

@clerk/react

npm i https://pkg.pr.new/@clerk/react@7844

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7844

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7844

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7844

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7844

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@7844

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7844

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7844

commit: c37d62c

coderabbitai

Actionable comments posted: 3

🤖 Fix all issues with AI agents

In `@packages/astro/src/server/keyless/index.ts`:
- Around line 10-14: The keyless() factory unconditionally calls
createFileStorage(), which imports Node-only modules and crashes in edge
runtimes; add a runtime Node check at the start of keyless() (e.g., verify
typeof process !== 'undefined' && process.versions?.node) and if Node is not
available throw a clear error explaining that keyless storage requires a Node
runtime, so createFileStorage() is never invoked in non-Node environments; keep
references to keyless(), keylessServiceInstance, createFileStorage(),
resolveKeysWithKeylessFallback(), and canUseKeyless when making this change.

In `@packages/nuxt/src/runtime/server/keyless/index.ts`:
- Around line 7-39: The current module-level singleton keylessServiceInstance
closes over the first request's event causing stale request context; change to
cache only the storage (e.g., createFileStorage) at module scope and instantiate
createKeylessService per request inside the keyless(event) function so that api
methods call clerkClient(event) with the current H3Event; specifically, keep a
cached storage variable (instead of keylessServiceInstance), and in
keyless(event) call createKeylessService({ storage: cachedStorage, api: {
createAccountlessApplication: async (headers?) => clerkClient(event)...,
completeOnboarding: async (headers?) => clerkClient(event)... }, framework:
'nuxt' }) so no module-level closure captures the first event.

packages/astro/src/server/keyless/index.ts

packages/nuxt/src/runtime/server/keyless/index.ts

packages/react-router/src/server/keyless/index.ts

The Nitro build failed because clerkMiddleware.js imports from ../utils/feature-flags and ./keyless/utils, but those directories were not included as tsup entry points, so they were missing from dist/.

Nuxt 4.1.2 has transitive dependency hoisting issues with npm install (used by pkglab), causing all nuxt dev instances to crash with missing packages like @clack/prompts, defu, and @jridgewell/trace-mapping.

These are server-only values matching how Next.js handles them (process.env.CLERK_API_URL, process.env.CLERK_API_VERSION). Now overridable via NUXT_CLERK_API_URL and NUXT_CLERK_API_VERSION.

…_API_URL Keep apiUrl/apiVersion in public runtime config for backwards compat but prefer private config (NUXT_CLERK_API_URL, NUXT_CLERK_API_VERSION) and log a deprecation warning when the public variant is used. This aligns with Next.js which reads CLERK_API_URL from process.env (server-only).

wobsoriano · 2026-04-09T15:22:45Z

!snapshot

wobsoriano · 2026-04-09T16:15:54Z

!snapshot

github-actions · 2026-04-09T16:18:58Z

Hey @wobsoriano - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.3.13-snapshot.v20260409161650
@clerk/astro	3.0.13-snapshot.v20260409161650
@clerk/backend	3.2.9-snapshot.v20260409161650
@clerk/chrome-extension	3.1.10-snapshot.v20260409161650
@clerk/clerk-js	6.6.1-snapshot.v20260409161650
@clerk/dev-cli	0.1.1-snapshot.v20260409161650
@clerk/expo	3.1.10-snapshot.v20260409161650
@clerk/expo-passkeys	1.0.11-snapshot.v20260409161650
@clerk/express	2.1.1-snapshot.v20260409161650
@clerk/fastify	3.1.11-snapshot.v20260409161650
@clerk/hono	0.1.11-snapshot.v20260409161650
@clerk/localizations	4.4.1-snapshot.v20260409161650
@clerk/msw	0.0.11-snapshot.v20260409161650
@clerk/nextjs	7.0.13-snapshot.v20260409161650
@clerk/nuxt	2.2.0-snapshot.v20260409161650
@clerk/react	6.2.2-snapshot.v20260409161650
@clerk/react-router	3.0.13-snapshot.v20260409161650
@clerk/shared	4.6.1-snapshot.v20260409161650
@clerk/tanstack-react-start	1.0.13-snapshot.v20260409161650
@clerk/testing	2.0.13-snapshot.v20260409161650
@clerk/ui	1.5.1-snapshot.v20260409161650
@clerk/upgrade	2.0.3-snapshot.v20260409161650
@clerk/vue	2.0.12-snapshot.v20260409161650

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.3.13-snapshot.v20260409161650 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.13-snapshot.v20260409161650 --save-exact

@clerk/backend

npm i @clerk/backend@3.2.9-snapshot.v20260409161650 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.1.10-snapshot.v20260409161650 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.6.1-snapshot.v20260409161650 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@0.1.1-snapshot.v20260409161650 --save-exact

@clerk/expo

npm i @clerk/expo@3.1.10-snapshot.v20260409161650 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.11-snapshot.v20260409161650 --save-exact

@clerk/express

npm i @clerk/express@2.1.1-snapshot.v20260409161650 --save-exact

@clerk/fastify

npm i @clerk/fastify@3.1.11-snapshot.v20260409161650 --save-exact

@clerk/hono

npm i @clerk/hono@0.1.11-snapshot.v20260409161650 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.4.1-snapshot.v20260409161650 --save-exact

@clerk/msw

npm i @clerk/msw@0.0.11-snapshot.v20260409161650 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.13-snapshot.v20260409161650 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.2.0-snapshot.v20260409161650 --save-exact

@clerk/react

npm i @clerk/react@6.2.2-snapshot.v20260409161650 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.13-snapshot.v20260409161650 --save-exact

@clerk/shared

npm i @clerk/shared@4.6.1-snapshot.v20260409161650 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.13-snapshot.v20260409161650 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.13-snapshot.v20260409161650 --save-exact

@clerk/ui

npm i @clerk/ui@1.5.1-snapshot.v20260409161650 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.3-snapshot.v20260409161650 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.12-snapshot.v20260409161650 --save-exact

packages/nuxt/src/runtime/plugin.ts

wobsoriano added 2 commits February 13, 2026 10:05

feat(nuxt): Introduce keyless mode

b943873

chore: clean up keyless logic

01c26c4

github-actions bot added integration astro react-router nuxt core-3 labels Feb 13, 2026

vercel bot deployed to Preview February 13, 2026 18:06 View deployment

wobsoriano added the do not merge label Feb 13, 2026

chore: remove unused type

e80b974

vercel bot temporarily deployed to Preview February 13, 2026 18:08 Inactive

chore: add changeset

ac444ee

Introduce Keyless quickstart for Nuxt, enabling use of the Clerk SDK without manual key setup.

wobsoriano changed the title ~~feat(nuxt): Add support for keyless mode~~ feat(nuxt): [WIP] Add support for keyless mode Feb 13, 2026

vercel bot deployed to Preview February 13, 2026 18:13 View deployment

coderabbitai bot reviewed Feb 13, 2026

View reviewed changes

packages/astro/src/server/keyless/index.ts Show resolved Hide resolved

packages/nuxt/src/runtime/server/keyless/index.ts Show resolved Hide resolved

packages/react-router/src/server/keyless/index.ts Show resolved Hide resolved

Merge branch 'main' into rob/nuxt-keyless

f8e080d

vercel bot deployed to Preview March 16, 2026 15:40 View deployment

fix(nuxt): add missing tsup entry points for keyless mode files

2ae15e6

The Nitro build failed because clerkMiddleware.js imports from ../utils/feature-flags and ./keyless/utils, but those directories were not included as tsup entry points, so they were missing from dist/.

vercel bot temporarily deployed to Preview March 16, 2026 17:06 Inactive

fix(integration): update nuxt template to 4.4.2

6e0497f

Nuxt 4.1.2 has transitive dependency hoisting issues with npm install (used by pkglab), causing all nuxt dev instances to crash with missing packages like @clack/prompts, defu, and @jridgewell/trace-mapping.

vercel bot deployed to Preview March 16, 2026 17:22 View deployment

Merge branch 'main' into rob/nuxt-keyless

7134248

vercel bot deployed to Preview March 16, 2026 17:52 View deployment

wobsoriano added 2 commits March 16, 2026 10:55

test: bump nuxt template versions

e476a00

chore: remove unused files

4c3d660

vercel bot deployed to Preview March 16, 2026 17:56 View deployment

revert: restore original integration env settings

9e8186d

vercel bot deployed to Preview March 17, 2026 13:32 View deployment

fix(nuxt): move apiUrl and apiVersion to private runtime config

61070c1

These are server-only values matching how Next.js handles them (process.env.CLERK_API_URL, process.env.CLERK_API_VERSION). Now overridable via NUXT_CLERK_API_URL and NUXT_CLERK_API_VERSION.

vercel bot temporarily deployed to Preview March 17, 2026 13:34 Inactive

vercel bot temporarily deployed to Preview March 17, 2026 15:29 Inactive

Merge branch 'main' into rob/nuxt-keyless

3416006

vercel bot deployed to Preview March 17, 2026 15:31 View deployment

chore: add changeset

d29eba9

vercel bot deployed to Preview March 17, 2026 15:38 View deployment

Merge branch 'main' into rob/nuxt-keyless

ad8328e

vercel bot deployed to Preview April 1, 2026 20:44 View deployment

wobsoriano removed the do not merge label Apr 1, 2026

Merge branch 'main' into rob/nuxt-keyless

ec0db85

vercel bot deployed to Preview April 9, 2026 14:58 View deployment

wobsoriano requested a review from Copilot April 9, 2026 15:08

Copilot started reviewing on behalf of wobsoriano April 9, 2026 15:09 View session

This comment was marked as resolved.

Sign in to view

wobsoriano removed the core-3 label Apr 9, 2026

tmilewski requested changes Apr 9, 2026

View reviewed changes

packages/nuxt/src/runtime/plugin.ts Outdated Show resolved Hide resolved

refactor(nuxt): use ClerkKeylessContext type in plugin

c37d62c

vercel bot temporarily deployed to Preview April 9, 2026 18:48 Inactive

tmilewski self-requested a review April 9, 2026 20:55

tmilewski approved these changes Apr 9, 2026

View reviewed changes

wobsoriano merged commit 68d1d8d into main Apr 9, 2026
42 checks passed

wobsoriano deleted the rob/nuxt-keyless branch April 9, 2026 21:46

clerk-cookie mentioned this pull request Apr 9, 2026

ci(repo): Version packages #8277

Open

Conversation

wobsoriano commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Changes

Checklist

Type of change

Uh oh!

changeset-bot bot commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

❌ Failed checks (1 warning)

Uh oh!

pkg-pr-new bot commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

wobsoriano commented Apr 9, 2026

Uh oh!

wobsoriano commented Apr 9, 2026

Uh oh!

github-actions bot commented Apr 9, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

wobsoriano commented Feb 13, 2026 •

edited

Loading

changeset-bot bot commented Feb 13, 2026 •

edited

Loading

vercel bot commented Feb 13, 2026 •

edited

Loading

coderabbitai bot commented Feb 13, 2026 •

edited

Loading

pkg-pr-new bot commented Feb 13, 2026 •

edited

Loading