Skip to content

Update TanStack Start skills for 1.0 - #95

Merged
SarahSoutoul merged 3 commits into
mainfrom
ss/DOCS-12250
Oct 7, 2026
Merged

SarahSoutoul merged 3 commits into
mainfrom
ss/DOCS-12250

Conversation

@SarahSoutoul

@SarahSoutoul SarahSoutoul commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Linear ticket

What does this solve? What changed?

TanStack Start 1.0 removed the Vinxi integration and legacy server route APIs. The published skills still instructed agents to use those APIs, and their custom src/start.ts examples omitted TanStack's default CSRF protection for server functions.

  • Replaces the Vinxi reference with a Vite and server setup guide, including tanstackStart(), createFileRoute('/path')({ server: { handlers } }), and the current src/routes/api/ layout.
  • Registers createCsrfMiddleware({ filter: (ctx) => ctx.handlerType === 'serverFn' }) before clerkMiddleware() in both the skill and template.
  • Updates the webhook example to createFileRoute, Route, and vite.config.ts, and fixes the Vite publishable-key variable name.
  • Revises the API-route evaluation and adds one for the CSRF setup.

Deadline

Aim to land before the TanStack Start 1.0 release on October 13.

After merge

Recommended order

  1. SDK — clerk/javascript#10102. Merge its follow-up Version Packages PR and verify the new @clerk/tanstack-react-start release before merging the Docs PR. Dashboard, Skills, and Quickstart can merge in any order.
  2. CLI — clerk/cli#523. Merge its follow-up Version Packages PR and verify a stable clerk@latest release before the docs PR.
  3. Dashboard — clerk/dashboard#10372.
  4. Skills — clerk/skills#95.
  5. Quickstart — clerk/clerk-tanstack-react-start-quickstart#16. Its existing Clerk SDK 1.6.4 lockfile entry already works with the PR's pinned Start and Router versions.
  6. Docs — clerk/clerk#3539. Merge last, after the SDK and CLI stable releases and the other source PRs. Remove its do not merge label only when those gates are met.

@SarahSoutoul SarahSoutoul self-assigned this Oct 6, 2026
@SarahSoutoul SarahSoutoul changed the title fix: update TanStack Start skills for 1.0 Update TanStack Start skills for 1.0 Oct 6, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@manovotny

Copy link
Copy Markdown
Collaborator

Pushed some changes directly in d19ad46.

  • Added viteReact() after tanstackStart() in the server-setup Vite example
  • Explained that a custom src/start.ts drops Start's default CSRF middleware, and that auth() throws without clerkMiddleware()
  • Updated the pitfalls row to the error auth() actually throws
  • Loosened eval 7 so a (context) => filter still passes
  • Kept the TanStack and React plugins in the ngrok vite.config.ts example
  • Noted that server routes can live anywhere under src/routes/

@SarahSoutoul SarahSoutoul removed the do not merge Prevents PRs from being merged while label is applied. label Oct 7, 2026
@SarahSoutoul
SarahSoutoul merged commit a02dbd2 into main Oct 7, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants