From c8f6d5e6fb035059d2009b949c72b8bd16a5e718 Mon Sep 17 00:00:00 2001
From: rumitvn <160252724+rumitvn@users.noreply.github.com>
Date: Sat, 13 Jun 2026 12:08:07 +0700
Subject: [PATCH] docs(start): fix ISR guide using non-existent
 prerender.routes option

The ISR guide configured prerendering via prerender.routes, which is not a
field on the prerender schema. Replace it with the supported pages array
(entry paths) plus prerender.crawlLinks to discover dynamic routes, matching
the static-prerendering guide and start-plugin-core schema.

Closes #7580
---
 docs/start/framework/react/guide/isr.md | 28 +++++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/docs/start/framework/react/guide/isr.md b/docs/start/framework/react/guide/isr.md
index 5704af1a11..54262f9817 100644
--- a/docs/start/framework/react/guide/isr.md
+++ b/docs/start/framework/react/guide/isr.md
@@ -34,9 +34,14 @@ export default defineConfig({
   plugins: [
     tanstackStart({
       prerender: {
-        routes: ['/blog', '/blog/posts/*'],
+        enabled: true,
+        // Crawl links from prerendered pages to discover and prerender
+        // dynamic routes such as individual blog posts.
         crawlLinks: true,
       },
+      // List the entry pages to prerender. Additional paths are discovered
+      // automatically via `crawlLinks` above and merged with this list.
+      pages: [{ path: '/blog' }],
     }),
   ],
 })
@@ -54,9 +59,14 @@ export default defineConfig({
     pluginReact(),
     tanstackStart({
       prerender: {
-        routes: ['/blog', '/blog/posts/*'],
+        enabled: true,
+        // Crawl links from prerendered pages to discover and prerender
+        // dynamic routes such as individual blog posts.
         crawlLinks: true,
       },
+      // List the entry pages to prerender. Additional paths are discovered
+      // automatically via `crawlLinks` above and merged with this list.
+      pages: [{ path: '/blog' }],
     }),
   ],
 })
@@ -423,9 +433,14 @@ export default defineConfig({
   plugins: [
     tanstackStart({
       prerender: {
-        routes: ['/blog', '/blog/posts/*'],
+        enabled: true,
+        // Crawl links from prerendered pages to discover and prerender
+        // dynamic routes such as individual blog posts.
         crawlLinks: true,
       },
+      // List the entry pages to prerender. Additional paths are discovered
+      // automatically via `crawlLinks` above and merged with this list.
+      pages: [{ path: '/blog' }],
     }),
   ],
 })
@@ -443,9 +458,14 @@ export default defineConfig({
     pluginReact(),
     tanstackStart({
       prerender: {
-        routes: ['/blog', '/blog/posts/*'],
+        enabled: true,
+        // Crawl links from prerendered pages to discover and prerender
+        // dynamic routes such as individual blog posts.
         crawlLinks: true,
       },
+      // List the entry pages to prerender. Additional paths are discovered
+      // automatically via `crawlLinks` above and merged with this list.
+      pages: [{ path: '/blog' }],
     }),
   ],
 })