From a64d2aedc05947028395a43f474df98dbd1fcf8e Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Tue, 11 Aug 2026 21:52:30 -0500 Subject: [PATCH 1/2] fix(nextjs): remove stray double space in clerkMiddleware detection error The default auth() case rendered "- clerkMiddleware()..." with two spaces because the prefixSteps ternary fell back to a single space combined with the literal "- " prefix. Fall back to an empty string so the first bullet renders with a single space, matching the docs. Co-Authored-By: Claude Opus 4.8 --- .changeset/tidy-cameras-jump.md | 5 +++++ packages/nextjs/src/server/errors.ts | 2 +- 2 files changed, 6 insertions(+), 1 deletion(-) create mode 100644 .changeset/tidy-cameras-jump.md diff --git a/.changeset/tidy-cameras-jump.md b/.changeset/tidy-cameras-jump.md new file mode 100644 index 00000000000..79c70df52bc --- /dev/null +++ b/.changeset/tidy-cameras-jump.md @@ -0,0 +1,5 @@ +--- +'@clerk/nextjs': patch +--- + +Fix a stray double space in the `auth()` "Clerk can't detect usage of clerkMiddleware()" error, so the first bullet renders as `- clerkMiddleware() is used in your Next.js middleware file.` diff --git a/packages/nextjs/src/server/errors.ts b/packages/nextjs/src/server/errors.ts index 07eb7efdd04..2cc8a8f1c7a 100644 --- a/packages/nextjs/src/server/errors.ts +++ b/packages/nextjs/src/server/errors.ts @@ -24,7 +24,7 @@ export const getAuthAuthHeaderMissing = () => authAuthHeaderMissing('getAuth', u export const authAuthHeaderMissing = (helperName = 'auth', prefixSteps?: string[], fileReference = 'middleware') => { return `Clerk: ${helperName}() was called but Clerk can't detect usage of clerkMiddleware(). Please ensure the following: -- ${prefixSteps ? [...prefixSteps, ''].join('\n- ') : ' '}clerkMiddleware() is used in your Next.js ${fileReference} file. +- ${prefixSteps ? [...prefixSteps, ''].join('\n- ') : ''}clerkMiddleware() is used in your Next.js ${fileReference} file. - Your ${fileReference} matcher is configured to match this route or page. - If you are using the src directory, make sure the ${fileReference} file is inside of it. From eaddce4c694e6e08c37efa6433eb4fd08bab035e Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Tue, 11 Aug 2026 22:33:25 -0500 Subject: [PATCH 2/2] docs: Correct changeset to reference getAuth() not auth() --- .changeset/tidy-cameras-jump.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.changeset/tidy-cameras-jump.md b/.changeset/tidy-cameras-jump.md index 79c70df52bc..87ab777af65 100644 --- a/.changeset/tidy-cameras-jump.md +++ b/.changeset/tidy-cameras-jump.md @@ -2,4 +2,4 @@ '@clerk/nextjs': patch --- -Fix a stray double space in the `auth()` "Clerk can't detect usage of clerkMiddleware()" error, so the first bullet renders as `- clerkMiddleware() is used in your Next.js middleware file.` +Fix a stray double space in the `getAuth()` "Clerk can't detect usage of clerkMiddleware()" error, so the first bullet renders as `- clerkMiddleware() is used in your Next.js middleware or proxy file.`