Repository navigation
static pre-rendering does not pre-render pages that are not linked #5455
Description
Which project does this relate to?
Start
Describe the bug
I have enabled pre-render.
tanstackStart({
prerender:{
enabled: true,
}
}),
I have the following routes
- index.tsx
- test1.tsx
- test2.tsx
index route has a link to test2 route.
I expect that all routes to be pre-rendered.
actual
only index, and test2 are pre-rendered.
Either this a bug in the code, or the documentation is not clear
according to the documentation, that if we don't specify a specify route to be re-rendered all routes will be prerenderd
Your Example Website or App
Steps to Reproduce the Bug or Issue
run pnpm build
output would be
Expected behavior
test1 should also be pre-rendered, even it's not linked in the home page
Screenshots or Videos
No response
Platform
"@tanstack/react-router": "^1.132.47",
"@tanstack/react-start": "^1.132.53",
"@vitejs/plugin-react": "^5.0.4",
"react": "^19.2.0",
"react-dom": "^19.2.0",
"vite": "^7.1.9"
Additional context
No response
Activity
FatahChan commentedon Oct 12, 2025
according the comment here, only the root path is pre-rendered.
https://github.com/TanStack/router/blob/main/packages/start-plugin-core/src/prerender.ts#L24
which mean the documentation is is incorrect.
however, I personally expect that all routes to be pre-rendered if, if no pages are specified, coming from Nextjs that would be the default behaviour
schiller-manuel commentedon Oct 12, 2025
we could only prerender static paths though, since dynamic paths require path params
we don't do that but could add this
FatahChan commentedon Oct 12, 2025
wdym by dynamic paths?
both test1 and test2 are static paths
schiller-manuel commentedon Oct 12, 2025
in your example, yes. but as soon as you add $param we can't prerender
FatahChan commentedon Oct 12, 2025
yes, I understand, my issue is that it wasn't documented properly, and was very confused.
for now, I think that the next course of actions, is to pre-render add static routes if user did not specify pages, and improve the documentation to inform devs that dynamic paths are not pre-rendered.
in the future, maybe something like getStaticPaths can be implemented
schiller-manuel commentedon Oct 12, 2025
yes, we want to add something like getStaticPaths in the future
FatahChan commentedon Oct 12, 2025
I am working on pr to fix my issue
nyomansunima commentedon Oct 13, 2025
Yeah, that's a good solutions.