Start: the Vite plugin and tsr generate write different routeTree.gen.ts (Start footer added, then stripped) #8437

Activity

1. schiller-manuel commented on Sep 15, 2026

   

   schiller-manuel

   on Sep 15, 2026

   Collaborator

   More actions

   yes, tsr CLI is not supported for start at the moment

   👍React with 👍1Reacted by Heet Mehta
2. schiller-manuel

   added

   enhancementNew feature or requestNew feature or request

   on Sep 15, 2026
3. p7gg commented on Oct 18, 2026

   

   p7gg

   on Oct 18, 2026

   More actions

   For anyone who needs the two in sync today, mirroring the plugin's footer into tsr.config.json works — tsr generate then writes the same file as vite dev / vite build:

   {
     "target": "react",
     "routeTreeFileFooter": [
       "import type { getRouter } from './router.tsx'\nimport type { createStart } from '@tanstack/react-start'\ndeclare module '@tanstack/react-start' {\n  interface Register {\n    ssr: true\n    router: Awaited<ReturnType<typeof getRouter>>\n  }\n}"
     ]
   }

   Notes:

   • The Start plugin replaces the generator's footer with its own (routeTreeFileFooter: getRouteTreeFileFooter in start-router-plugin), so there's no duplication in Vite mode — both tools end up writing identical output.
   • The static entry is only equivalent while the app has no src/start.ts: with one, the plugin footer also imports startInstance and adds a config line that the static entry would need to mirror.
   • Verified with @tanstack/router-cli 1.167.45, @tanstack/start-plugin-core 1.171.54, @tanstack/react-start 1.169.3, Vite 8, and Nitro 3 (nitro/vite plugin).
4. Sheraff

   added a commit that references this issue on Oct 25, 2026

   fix(start-plugin-core): keep router.plugins and the route tree code s…

   ...

   f1cbd5f
5. EduKegler commented on Oct 30, 2026

   

   EduKegler

   on Oct 30, 2026

   More actions

   Besides the silent any described above, the missing footer can fail tsc. If src/start.ts has request middleware that adds context, the footer's config line is what types getGlobalStartContext():

   // src/start.ts
   const nonce = createMiddleware().server(({ next }) =>
     next({ context: { nonce: 'abc' } }),
   )
   
   export const startInstance = createStart(() => ({
     requestMiddleware: [nonce],
   }))
   
   // src/nonce.ts
   export const nonce = () => getGlobalStartContext()?.nonce

   After vite build, tsc passes. After tsr generate, it fails until the next Vite run:

   src/nonce.ts(3,53): error TS2339: Property 'nonce' does not exist on type 'never'.
   

   I opened TanStack/cli#526 so that new Start apps generate routes with vite build instead of tsr generate. The Router CLI docs could still say that the CLI is not for Start projects.