chore(nuxt): Remove createRouteMatcher support

[wobsoriano]

Description

This PR removes createRouteMatcher from @clerk/nuxt, following the same removal we did for Astro in #8974.

Another thing, since Nuxt 3 reaches end-of-life on July 31, 2026, we now require Nuxt 4.

Docs PR: https://github.com/clerk/clerk/pull/3043

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

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

[changeset-bot]

🦋 Changeset detected

Latest commit: 8c0ea70

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

This PR includes changesets to release 1 package

Name	Type
@clerk/nuxt	Major

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]

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jul 28, 2026 5:23pm
swingset	Ready	Preview, Comment	Jul 28, 2026 5:23pm

[pkg-pr-new]

Open in StackBlitz

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9258

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9258

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9258

@clerk/expo

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

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9258

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 8c0ea70

[wobsoriano]

!allow-major

[github-actions]

API Changes Report

Generated by Break Check on 2026-07-28T17:27:21.250Z

Summary

Metric	Count
Packages analyzed	19
Packages with changes	1
🔴 Breaking changes	1
🟡 Non-breaking changes	0
🟢 Additions	0

Warning
1 breaking change(s) detected - Major version bump required

🤖 This report was reviewed by claude-sonnet-4-6.

🔴 Breaking changes index (1)

Every breaking change, up front. Full diffs are in the package sections below.

Package	Subpath	Change
@clerk/nuxt	./server	createRouteMatcher

---

@clerk/nuxt

Current version: 2.6.23
Recommended bump: MAJOR → 3.0.0

Subpath ./server

🔴 Breaking Changes (1)

Changed: createRouteMatcher

- createRouteMatcher: (routes: RouteMatcherParam) => (event: H3Event) => boolean

Static analyzer: Removed function createRouteMatcher

🤖 AI review (confirmed) (97%): The createRouteMatcher function was entirely removed from the public API of @clerk/nuxt (./server), so any consumer calling it will fail to compile.

Migration: Import createRouteMatcher from @clerk/nuxt/server's upstream package (e.g., @clerk/express or whichever package still exports it), or vendor the equivalent route-matching logic directly.

---

Report generated by Break Check

_{Last ran on 8c0ea70.}

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: af37cb05-2a67-4cd9-b0e9-aa4da756be4b

📥 Commits

Reviewing files that changed from the base of the PR and between 4dc1c4e and 5b2f2d1.

📒 Files selected for processing (3)

• .changeset/major-nuxt-drop-nuxt-3.md
• .changeset/major-nuxt-remove-route-matcher.md
• packages/nuxt/package.json

🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

• clerk/clerk_go (manual)
• clerk/dashboard (manual)
• clerk/accounts (manual)
• clerk/backoffice (manual)
• clerk/clerk (manual) → reviewed against open PR #3043 rob/nuxt-crm-removal instead of the default branch
• clerk/clerk-docs (manual)
• clerk/cloudflare-workers (manual)
• clerk/cli (auto-detected)
• clerk/clerk-ios (auto-detected)
• clerk/clerk-android (auto-detected)

🚧 Files skipped from review as they are similar to previous changes (2)

• .changeset/major-nuxt-drop-nuxt-3.md
• .changeset/major-nuxt-remove-route-matcher.md

---

📝 Walkthrough

Walkthrough

The PR makes @clerk/nuxt require Nuxt 4 and newer Node.js versions, and removes createRouteMatcher from client and server exports and auto-imports. Authentication guidance and integration templates now use resource-level API checks and named Nuxt route middleware for pages. Middleware integration tests cover unauthorized responses and encoded or malformed paths, while server tests perform normalized pathname checks directly.

Estimated code review effort: 3 (Moderate) | ~20 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: removing createRouteMatcher support in the Nuxt package.
Description check	✅ Passed	The description matches the changeset by describing createRouteMatcher removal and the Nuxt 4 requirement.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Warning

Review ran into problems

🔥 Problems

Linked repositories: Couldn't analyze clerk/clerk-android - clone failed: Clone operation failed: Cloning into '/home/jailuser/git'...
From https://github.com/clerk/clerk-android

• branch HEAD -> FETCH_HEAD
  Downloading config/bin/detekt-cli (71 MB)
  Error downloading object: config/bin/detekt-cli (2655f48): Smudge error: Error downloading config/bin/detekt-cli (2655f48c7c303a5f9bf920a33229408b8571bb1d29e4e57cf7be3e151bceecb1): LFS: Client error: https://github-cloud.githubusercontent.com/alambic/media/877189286/26/55/2655f48c7c303a5f9bf920a33229408b8571bb1d29e4e57cf7be3e151bceecb1?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA5BA2674WPWWEFGQ5%2F20260728%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260728T170733Z&X-Amz-Expires=3600&X-Amz-Signature=48a191e534623a1c9c623066d8222a170e430d0060ddf9607ba9ae85a01c737d&X-Amz-SignedHeaders=host&actor_id=136622811&key_id=0&repo_id=980409545&token=1

Errors logged to '/home/jailuser/git/.git/lfs/logs/20260728T170734.076860877.log'.
Use git lfs logs last to view the log.
error: external filter 'git-lfs filter-process' failed
fatal: config/bin/detekt-cli: smudge filter lfs failed
Downloading config/bin/detekt-cli (71 MB)
Error downloading object: config/bin/detekt-cli (2655f48): Smudge error: Error downloading config/bin/detekt-cli (2655f48c7c303a5f9bf920a33229408b8571bb1d29e4e57cf7be3e151bceecb1): LFS: Client error: https://github-cloud.githubusercontent.com/alambic/media/877189286/26/55/2655f48c7c303a5f9bf920a33229408b8571bb1d29e4e57cf7be3e151bceecb1?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA5BA2674WPWWEFGQ5%2F20260728%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260728T170855Z&X-Amz-Expires=3600&X-Amz-Signature=a862c060b5304ae3b2e395e869b9c58d871e0e8f5698fea7b6a118230ae33a76&X-Amz-SignedHeaders=host&actor_id=136622811&key_id=0&repo_id=980409545&token=1

Errors logged to '/home/jailuser/git/.git/lfs/logs/20260728T170855.560379798.log'.
Use git lfs logs last to view the log.
error: external filter 'git-lfs filter-process' failed
fatal: config/bin/detekt-cli: smudge filter lfs failed

---

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