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: 4dc1c4e

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 27, 2026 8:41pm
swingset	Ready	Preview, Comment	Jul 27, 2026 8:41pm

[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: 4dc1c4e

[wobsoriano]

!allow-major

[github-actions]

API Changes Report

Generated by Break Check on 2026-07-27T20:41:29.725Z

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.22
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 has been removed from the public API of @clerk/nuxt (./server), so any consumer importing and calling it will fail to compile.

Migration: Import createRouteMatcher from @clerk/nuxt/server's peer package (e.g., @clerk/nuxt main entry or h3-compatible utilities) or implement an equivalent route-matching helper manually.

---

Report generated by Break Check

_{Last ran on 4dc1c4e.}

[coderabbitai]

📝 Walkthrough

Walkthrough

The PR makes @clerk/nuxt require Nuxt 4 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
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.
Title check	✅ Passed	The title clearly matches the main change: removing createRouteMatcher support from @clerk/nuxt.
Description check	✅ Passed	The description is directly related and accurately summarizes the Nuxt createRouteMatcher removal and Nuxt 4 requirement.

---

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