Use new TanStack RC setup by wobsoriano · Pull Request #2690 · clerk/clerk-docs

wobsoriano · 2025-10-09T20:30:07Z

🔎 Previews:

What does this solve?

We've updated our SDK to support TanStack Start RC. The custom server handler sections of our docs are now outdated, as we introduced a clerkMiddleware() in our SDK. See feat(tanstack-react-start): Introduce middleware and support for TanStack Start RC javascript#6859

What changed?

Updates pages where custom server handler (createClerkHandler) is used and replaced with clerkMiddleware() usage.
Updates getAuth(request) to use auth()

Checklist

I have clicked on "Files changed" and performed a thorough self-review
All existing checks pass

vercel · 2025-10-09T20:30:13Z

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

Project	Deployment	Preview	Updated (UTC)
clerk-docs	Ready	Preview	Oct 17, 2025 5:58pm

💡 Enable Vercel Agent with $100 free credit for automated AI reviews

wobsoriano · 2025-10-14T16:21:48Z

Marking this as ready for review ahead of our SDK release today.

…tanstack-start-rc

SarahSoutoul · 2025-10-14T16:47:12Z

docs review

@wobsoriano Have added some redirects for the old links here: docs review and left a comment.

The rest looks good to me, but wanna test out the new quickstart first.

SarahSoutoul · 2025-10-14T21:23:19Z

@alexisintech have now given this an extensive review, but wanted to get your eyes on it for final approval.

Quickstart PR associated with this is here: clerk/clerk-tanstack-react-start-quickstart#5.

Think we also need a Dashboard PR to update onboarding docs, if I'm not mistaken @wobsoriano. Happy to do it if it's not in the making.

manovotny · 2025-10-14T21:55:28Z

I would prefer @alexisintech gives official approval, but from what I see, this LGTM. 👍

richardvanbergen · 2025-10-15T02:17:57Z

@wobsoriano Thank you very much for your hard work on this. I wasn't sure whether to create an issue or if it's a problem with documentation (my setup) but I thought I should at least tell you before you publish an announcement or something. If you want I can create an issue instead.

After adding the middleware

import { clerkMiddleware } from '@clerk/tanstack-react-start/server';
import { createStart } from '@tanstack/react-start';

export const startInstance = createStart(() => {
  return {
    requestMiddleware: [clerkMiddleware()],
  };
});

I get the following on every request:

TypeError: Cannot read properties of undefined (reading 'get')
    at AuthenticateContext.getCookie (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:388:38)
    ... 8 lines matching cause stack trace ...
    at next (/Users/rich/Code/workwings/node_modules/@tanstack/start-server-core/dist/esm/createStartHandler.js:480:16) {
  cause: TypeError: Cannot read properties of undefined (reading 'get')
      at AuthenticateContext.getCookie (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:388:38)
      at AuthenticateContext.getSuffixedCookie (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:391:17)
      at AuthenticateContext.usesSuffixedCookies (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:252:36)
      at AuthenticateContext.getSuffixedOrUnSuffixedCookie (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:394:14)
      at AuthenticateContext.initCookieValues (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:371:38)
      at new AuthenticateContext (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:237:12)
      at createAuthenticateContext (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:436:10)
      at authenticateRequest (file:///Users/rich/Code/workwings/node_modules/@clerk/backend/dist/chunk-BY3VEEDM.mjs:4994:31)
      at /Users/rich/Code/workwings/node_modules/@clerk/tanstack-react-start/dist/server/clerkMiddleware.js:16:26
      at next (/Users/rich/Code/workwings/node_modules/@tanstack/start-server-core/dist/esm/createStartHandler.js:480:16),
  status: 500,
  statusText: undefined,
  headers: undefined,
  data: undefined,
  body: undefined,
  unhandled: true
}

This is my current package versions. I've checked the PRs and made sure I have the latest clerk libraries but no success:

{
  "name": "[redacted]",
  "private": true,
  "type": "module",
  "scripts": {
    "dev": "vite dev --port 3000",
    "build": "vite build",
    "start": "node .output/server/index.mjs",
    "serve": "vite preview",
    "test": "vitest run",
    "format": "biome format",
    "lint": "biome lint",
    "check": "biome check",
    "storybook": "storybook dev -p 6006",
    "build-storybook": "storybook build",
    "machine-translate": "inlang machine translate --project project.inlang"
  },
  "dependencies": {
    "@auth/core": "0.37.0",
    "@clerk/backend": "^2.18.0",
    "@clerk/clerk-js": "^5.100.0",
    "@clerk/clerk-react": "^5.52.0",
    "@clerk/tanstack-react-start": "^0.26.0",
    "@convex-dev/auth": "^0.0.90",
    "@convex-dev/react-query": "0.0.0-alpha.11",
    "@faker-js/faker": "^10.0.0",
    "@orpc/client": "^1.7.5",
    "@orpc/json-schema": "^1.7.5",
    "@orpc/openapi": "^1.7.5",
    "@orpc/server": "^1.7.5",
    "@orpc/tanstack-query": "^1.7.5",
    "@orpc/zod": "^1.7.5",
    "@radix-ui/react-accordion": "^1.2.12",
    "@radix-ui/react-label": "^2.1.7",
    "@radix-ui/react-select": "^2.2.6",
    "@radix-ui/react-slider": "^1.3.6",
    "@radix-ui/react-slot": "^1.2.3",
    "@radix-ui/react-switch": "^1.2.6",
    "@storybook/react-vite": "^9.1.9",
    "@t3-oss/env-core": "^0.13.8",
    "@tailwindcss/vite": "^4.0.6",
    "@tanstack/match-sorter-utils": "^8.19.4",
    "@tanstack/react-devtools": "^0.7.0",
    "@tanstack/react-form": "^1.0.0",
    "@tanstack/react-query": "^5.66.5",
    "@tanstack/react-query-devtools": "^5.84.2",
    "@tanstack/react-router": "^1.132.0",
    "@tanstack/react-router-devtools": "^1.132.0",
    "@tanstack/react-router-ssr-query": "^1.131.7",
    "@tanstack/react-router-with-query": "^1.130.17",
    "@tanstack/react-start": "^1.132.0",
    "@tanstack/react-store": "^0.7.0",
    "@tanstack/react-table": "^8.21.2",
    "@tanstack/router-plugin": "^1.132.0",
    "@tanstack/store": "^0.7.0",
    "class-variance-authority": "^0.7.1",
    "clsx": "^2.1.1",
    "convex": "^1.27.3",
    "lucide-react": "^0.544.0",
    "nitro": "npm:nitro-nightly",
    "posthog-js": "^1.273.1",
    "react": "^19.0.0",
    "react-dom": "^19.0.0",
    "storybook": "^9.1.9",
    "tailwind-merge": "^3.0.2",
    "tailwindcss": "^4.0.6",
    "tw-animate-css": "^1.3.6",
    "vite-tsconfig-paths": "^5.1.4",
    "zod": "^4.1.11"
  },
  "devDependencies": {
    "@biomejs/biome": "2.2.4",
    "@inlang/cli": "^3.0.0",
    "@inlang/paraglide-js": "2.4.0",
    "@tanstack/devtools-event-client": "^0.3.2",
    "@testing-library/dom": "^10.4.0",
    "@testing-library/react": "^16.2.0",
    "@types/node": "^22.10.2",
    "@types/react": "^19.0.8",
    "@types/react-dom": "^19.0.3",
    "@vitejs/plugin-react": "^5.0.4",
    "jsdom": "^27.0.0",
    "typescript": "^5.7.2",
    "vite": "^7.1.7",
    "vitest": "^3.0.5",
    "web-vitals": "^5.1.0"
  },
  "trustedDependencies": [
    "@clerk/shared",
    "@tailwindcss/oxide",
    "browser-tabs-lock",
    "core-js"
  ]
}

wobsoriano · 2025-10-15T02:22:30Z

@richardvanbergen there's an upstream issue with a TanStack dependency and the fix is to pin srvx version to 0.8.15. See this integration test fix

richardvanbergen · 2025-10-15T02:37:25Z

@wobsoriano Sorry that didn't work I:

Locked the package versions to the versions here.
Deleted the lock file and node modules.
Re-install from scratch.

I still see the same error.

I'm going to try and see if I can make a minimal reproduction repo. if I can't then I'll just migrate my app over to it. If I can I'll post it to clerk/backend issues.

richardvanbergen · 2025-10-15T03:22:37Z

Nevermind. I couldn't reproduce in another repo. So I just started deleting stuff from my package.json and trying to get it to match the new repo as best I could. Then it suddenly started working, I don't know what caused it. My guess is some pnpm or vite cache nonsense.

Sorry for the extra chatter and congratulations on a newly shipped feature!

SarahSoutoul · 2025-10-15T17:08:40Z

@alexisintech have now given this an extensive review, but wanted to get your eyes on it for final approval.

Quickstart PR associated with this is here: clerk/clerk-tanstack-react-start-quickstart#5.

Think we also need a Dashboard PR to update onboarding docs, if I'm not mistaken @wobsoriano. Happy to do it if it's not in the making.

Here you go: https://github.com/clerk/dashboard/pull/7313.

alexisintech · 2025-10-15T17:54:17Z

@SarahSoutoul @wobsoriano taking a look now

alexisintech

I've posted my review - if you agree with these changes @wobsoriano I can update the quickstart repo to match these changes :)

Co-authored-by: Robert Soriano <sorianorobertc@gmail.com>

SarahSoutoul · 2025-10-16T16:43:13Z

I've posted my review - if you agree with these changes @wobsoriano I can update the quickstart repo to match these changes :)

To both of you @alexisintech @wobsoriano, have updated the Dashboard PR accordingly after the recent changes if you could have another quick link: https://github.com/clerk/dashboard/pull/7313/files. Didn't include the srvx stuff given it's a temporary thing, but doesn't hurt to add it as a callout in the dashboard onboarding too. Let me know thoughts.

alexisintech · 2025-10-16T19:04:56Z

I've posted my review - if you agree with these changes @wobsoriano I can update the quickstart repo to match these changes :)

To both of you @alexisintech @wobsoriano, have updated the Dashboard PR accordingly after the recent changes if you could have another quick link: https://github.com/clerk/dashboard/pull/7313/files. Didn't include the srvx stuff given it's a temporary thing, but doesn't hurt to add it as a callout in the dashboard onboarding too. Let me know thoughts.

I'm going to mark this as blocked until we have rob's responses!

wobsoriano · 2025-10-16T20:04:17Z

@alexisintech @SarahSoutoul tbh I think we can skip the srvx part as we already have plenty of references (discord, github) on why it's not working currently and we can always reference that. I talked to one of the TanStack maintainers and they said they're gonna look into it.

SarahSoutoul · 2025-10-17T18:02:22Z

I think we might be good to go no? @alexisintech @wobsoriano

wobsoriano · 2025-10-17T18:23:04Z

merging it!

Use new TanStack RC setup

5b7541e

vercel Bot had a problem deploying to Preview October 9, 2025 20:30 Failure

fix links

1dc481a

vercel Bot had a problem deploying to Preview October 9, 2025 20:36 Failure

chore: remove org sync for now

39c3c9a

vercel Bot deployed to Preview October 9, 2025 20:39

View deployment

Merge branch 'main' into rob/tanstack-start-rc

17a8a9b

vercel Bot deployed to Preview October 11, 2025 18:01

View deployment

Merge branch 'main' into rob/tanstack-start-rc

72f9aa7

vercel Bot deployed to Preview October 14, 2025 16:19

View deployment

wobsoriano marked this pull request as ready for review October 14, 2025 16:21

wobsoriano requested a review from a team as a code owner October 14, 2025 16:21

SarahSoutoul reviewed Oct 14, 2025

View reviewed changes

Comment thread docs/guides/development/verifying-oauth-access-tokens.tanstack-react-start.mdx Resolved

SarahSoutoul added 2 commits October 14, 2025 10:44

docs review

37bbbcc

Merge remote-tracking branch 'origin/rob/tanstack-start-rc' into rob/…

bd656f1

…tanstack-start-rc

vercel Bot deployed to Preview October 14, 2025 16:46

View deployment

SarahSoutoul reviewed Oct 14, 2025

View reviewed changes

Comment thread docs/reference/tanstack-react-start/overview.mdx Resolved

manovotny reviewed Oct 14, 2025

View reviewed changes

Comment thread docs/getting-started/quickstart.tanstack-react-start.mdx Resolved

SarahSoutoul mentioned this pull request Oct 14, 2025

Migrate to TanStack Start RC clerk/clerk-tanstack-react-start-quickstart#5

Merged

Merge branch 'main' into rob/tanstack-start-rc

69c00e4

vercel Bot deployed to Preview October 14, 2025 19:47

View deployment

wobsoriano added 3 commits October 14, 2025 13:49

chore: remove getAuth use

e9d663b

more fixes

024016c

add clerkMiddleware to start overview

f2f9111

vercel Bot deployed to Preview October 14, 2025 20:52

View deployment

vercel Bot deployed to Preview October 14, 2025 20:59

View deployment

SarahSoutoul force-pushed the rob/tanstack-start-rc branch from 69032d9 to f2f9111 Compare October 14, 2025 21:02

Merge branch 'main' into rob/tanstack-start-rc

fe7cafa

vercel Bot deployed to Preview October 14, 2025 21:23

View deployment

SarahSoutoul requested review from a team and alexisintech October 14, 2025 21:26

Merge branch 'main' into rob/tanstack-start-rc

f1369b3

vercel Bot deployed to Preview October 15, 2025 17:57

View deployment

docs review

733eac4

vercel Bot deployed to Preview October 15, 2025 19:54

View deployment

alexisintech approved these changes Oct 15, 2025

View reviewed changes

wobsoriano commented Oct 16, 2025

View reviewed changes

Comment thread docs/getting-started/quickstart.tanstack-react-start.mdx Resolved

Update docs/getting-started/quickstart.tanstack-react-start.mdx

3e64eae

Co-authored-by: Robert Soriano <sorianorobertc@gmail.com>

vercel Bot deployed to Preview October 16, 2025 16:29

View deployment

alexisintech added the do not merge label Oct 16, 2025

remove srvx section

08e84ab

vercel Bot deployed to Preview October 17, 2025 17:58

View deployment

wobsoriano merged commit 9cfdb7f into main Oct 17, 2025
7 checks passed

wobsoriano deleted the rob/tanstack-start-rc branch October 17, 2025 18:23

Conversation

wobsoriano commented Oct 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔎 Previews:

What does this solve?

What changed?

Checklist

Uh oh!

vercel Bot commented Oct 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wobsoriano commented Oct 14, 2025

Uh oh!

Uh oh!

SarahSoutoul commented Oct 14, 2025

Uh oh!

Uh oh!

Uh oh!

SarahSoutoul commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

manovotny commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

richardvanbergen commented Oct 15, 2025

Uh oh!

wobsoriano commented Oct 15, 2025

Uh oh!

richardvanbergen commented Oct 15, 2025

Uh oh!

richardvanbergen commented Oct 15, 2025

Uh oh!

SarahSoutoul commented Oct 15, 2025

Uh oh!

alexisintech commented Oct 15, 2025

Uh oh!

alexisintech left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

SarahSoutoul commented Oct 16, 2025

Uh oh!

alexisintech commented Oct 16, 2025

Uh oh!

wobsoriano commented Oct 16, 2025

Uh oh!

SarahSoutoul commented Oct 17, 2025

Uh oh!

wobsoriano commented Oct 17, 2025

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

wobsoriano commented Oct 9, 2025 •

edited

Loading

vercel Bot commented Oct 9, 2025 •

edited

Loading

SarahSoutoul commented Oct 14, 2025 •

edited

Loading

manovotny commented Oct 14, 2025 •

edited

Loading