Skip to content
Source
Sign inSign up
TanStack/router

feat(start): add route sitemap metadata and streamed output #8294

OpenLadyBluenotes(GitHub profile, opens in a new tab)wants to merge 6 commits intofeat/start-prerender-params fromfeat/start-route-sitemapsopened

🎯 Changes

Add route-level and per-entry sitemap metadata, with streamed sitemap and pages.json output.

Built on #8293. Split from #7346, based on @nikuscs's work.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested code changes locally with the relevant test commands, or tests do not apply to this pull request.
  • I fully understand the code in this pull request, including any code generated with AI assistance.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).
    1. github-actions[bot](GitHub profile, opens in a new tab) added labelsdocumentation

    2. github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: start-plugin-core

    3. github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: start-client-core

    4. Important

      Review skipped

      Auto reviews are disabled on base/target branches other than the default branch.

      Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

      Run configuration

      You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

      Use the checkbox below for a quick retry:

      • 🔍 Trigger review
      • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

      Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

      ❤️ Share
      Comment `@coderabbitai help` to get the list of available commands.
    5. View your CI Pipeline Execution ↗ for commit 0082cc297f59544b24bccfddab9185d7220dea85

      CommandStatusDurationResult
      nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 54sView ↗

      ☁️ Nx Cloud last updated this comment at 2026-10-24 22:30:45 UTC

    6. 🚀 Changeset Version Preview

      5 package(s) bumped directly, 18 bumped as dependents.

      🟨 Minor bumps

      PackageVersionReason
      @tanstack/start-client-core1.170.39 → 1.171.0Changeset
      @tanstack/start-plugin-core1.171.55 → 1.172.0Changeset

      🟩 Patch bumps

      PackageVersionReason
      @tanstack/router-core1.171.39 → 1.171.40Changeset
      @tanstack/router-plugin1.168.48 → 1.168.49Changeset
      @tanstack/start-server-core1.169.45 → 1.169.46Changeset
      @tanstack/react-router1.170.46 → 1.170.47Dependent
      @tanstack/react-start1.169.4 → 1.169.5Dependent
      @tanstack/react-start-client1.168.44 → 1.168.45Dependent
      @tanstack/react-start-rsc0.1.65 → 0.1.66Dependent
      @tanstack/react-start-server1.167.52 → 1.167.53Dependent
      @tanstack/router-cli1.167.46 → 1.167.47Dependent
      @tanstack/router-generator1.167.46 → 1.167.47Dependent
      @tanstack/router-vite-plugin1.167.48 → 1.167.49Dependent
      @tanstack/solid-router1.170.43 → 1.170.44Dependent
      @tanstack/solid-start1.169.4 → 1.169.5Dependent
      @tanstack/solid-start-client1.168.42 → 1.168.43Dependent
      @tanstack/solid-start-server1.167.50 → 1.167.51Dependent
      @tanstack/start-static-server-functions1.167.44 → 1.167.45Dependent
      @tanstack/start-storage-context1.167.41 → 1.167.42Dependent
      @tanstack/vue-router1.170.42 → 1.170.43Dependent
      @tanstack/vue-start1.169.4 → 1.169.5Dependent
      @tanstack/vue-start-client1.167.45 → 1.167.46Dependent
      @tanstack/vue-start-server1.167.50 → 1.167.51Dependent
    7. Bundle Size Benchmarks

      • Commit: 5a1da754c545
      • Measured at: 2026-10-24T22:14:47.459Z
      • Baseline source: history:6b9fe6d29552
      • Dashboard: bundle-size history

      The following scenarios have bundle-size changes compared with the baseline:

      ScenarioCurrent (gzip)Initial (gzip)RawBrotliTrend
      react-router.minimal84.0 KiB
      -19 B
      83.9 KiB
      -18 B
      261.4 KiB
      -6 B
      73.3 KiB
      +35 B
      ███████████▁
      react-router.full87.6 KiB
      +24 B
      87.5 KiB
      +24 B
      273.3 KiB
      +10 B
      76.4 KiB
      +10 B
      ▁▁▁▁▁▁▁▁▁▁▁█
      solid-router.minimal33.3 KiB
      -9 B
      33.2 KiB
      -11 B
      95.2 KiB
      +3 B
      30.2 KiB
      +48 B
      ███████████▁
      solid-router.full38.3 KiB
      0 B
      38.1 KiB
      +2 B
      110.0 KiB
      0 B
      34.5 KiB
      +18 B
      ▅▅▅▅▅▅▅▅▅▅▅
      vue-router.minimal49.4 KiB
      -6 B
      49.3 KiB
      -5 B
      136.5 KiB
      0 B
      44.8 KiB
      -19 B
      ███████████▁
      vue-router.full55.0 KiB
      -18 B
      54.9 KiB
      -18 B
      154.6 KiB
      0 B
      49.7 KiB
      +4 B
      ███████████▁
      solid-start.minimal46.2 KiB
      -2 B
      46.0 KiB
      -3 B
      135.1 KiB
      0 B
      41.2 KiB
      +33 B
      ███████████▁
      solid-start.deferred-hydration49.2 KiB
      -4 B
      46.1 KiB
      -4 B
      142.4 KiB
      0 B
      43.9 KiB
      +15 B
      ███████████▁
      solid-start.full51.2 KiB
      +4 B
      51.1 KiB
      +2 B
      150.0 KiB
      0 B
      45.5 KiB
      -5 B
      ▁▁▁▁▁▁▁▁▁▁▁█
      vue-start.minimal65.4 KiB
      -14 B
      65.2 KiB
      -14 B
      185.7 KiB
      0 B
      58.4 KiB
      -72 B
      ███████████▁
      vue-start.full69.1 KiB
      -10 B
      69.0 KiB
      -12 B
      197.6 KiB
      0 B
      61.5 KiB
      -85 B
      ███████████▁

      Current gzip tracks all emitted client JS chunks. Initial gzip tracks only the entry/import graph. Trend sparkline is historical current gzip ending with this PR measurement; lower is better.

    8. More templates

      @tanstack/arktype-adapter

      npm i https://pkg.pr.new/@tanstack/arktype-adapter@8294

      @tanstack/eslint-plugin-router

      npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@8294

      @tanstack/eslint-plugin-start

      npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@8294

      @tanstack/history

      npm i https://pkg.pr.new/@tanstack/history@8294

      @tanstack/react-router

      npm i https://pkg.pr.new/@tanstack/react-router@8294

      @tanstack/react-router-devtools

      npm i https://pkg.pr.new/@tanstack/react-router-devtools@8294

      @tanstack/react-router-ssr-query

      npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@8294

      @tanstack/react-start

      npm i https://pkg.pr.new/@tanstack/react-start@8294

      @tanstack/react-start-client

      npm i https://pkg.pr.new/@tanstack/react-start-client@8294

      @tanstack/react-start-rsc

      npm i https://pkg.pr.new/@tanstack/react-start-rsc@8294

      @tanstack/react-start-server

      npm i https://pkg.pr.new/@tanstack/react-start-server@8294

      @tanstack/router-cli

      npm i https://pkg.pr.new/@tanstack/router-cli@8294

      @tanstack/router-core

      npm i https://pkg.pr.new/@tanstack/router-core@8294

      @tanstack/router-devtools

      npm i https://pkg.pr.new/@tanstack/router-devtools@8294

      @tanstack/router-devtools-core

      npm i https://pkg.pr.new/@tanstack/router-devtools-core@8294

      @tanstack/router-generator

      npm i https://pkg.pr.new/@tanstack/router-generator@8294

      @tanstack/router-plugin

      npm i https://pkg.pr.new/@tanstack/router-plugin@8294

      @tanstack/router-ssr-query-core

      npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@8294

      @tanstack/router-utils

      npm i https://pkg.pr.new/@tanstack/router-utils@8294

      @tanstack/router-vite-plugin

      npm i https://pkg.pr.new/@tanstack/router-vite-plugin@8294

      @tanstack/solid-router

      npm i https://pkg.pr.new/@tanstack/solid-router@8294

      @tanstack/solid-router-devtools

      npm i https://pkg.pr.new/@tanstack/solid-router-devtools@8294

      @tanstack/solid-router-ssr-query

      npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@8294

      @tanstack/solid-start

      npm i https://pkg.pr.new/@tanstack/solid-start@8294

      @tanstack/solid-start-client

      npm i https://pkg.pr.new/@tanstack/solid-start-client@8294

      @tanstack/solid-start-server

      npm i https://pkg.pr.new/@tanstack/solid-start-server@8294

      @tanstack/start-client-core

      npm i https://pkg.pr.new/@tanstack/start-client-core@8294

      @tanstack/start-fn-stubs

      npm i https://pkg.pr.new/@tanstack/start-fn-stubs@8294

      @tanstack/start-plugin-core

      npm i https://pkg.pr.new/@tanstack/start-plugin-core@8294

      @tanstack/start-server-core

      npm i https://pkg.pr.new/@tanstack/start-server-core@8294

      @tanstack/start-static-server-functions

      npm i https://pkg.pr.new/@tanstack/start-static-server-functions@8294

      @tanstack/start-storage-context

      npm i https://pkg.pr.new/@tanstack/start-storage-context@8294

      @tanstack/valibot-adapter

      npm i https://pkg.pr.new/@tanstack/valibot-adapter@8294

      @tanstack/virtual-file-routes

      npm i https://pkg.pr.new/@tanstack/virtual-file-routes@8294

      @tanstack/vue-router

      npm i https://pkg.pr.new/@tanstack/vue-router@8294

      @tanstack/vue-router-devtools

      npm i https://pkg.pr.new/@tanstack/vue-router-devtools@8294

      @tanstack/vue-router-ssr-query

      npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@8294

      @tanstack/vue-start

      npm i https://pkg.pr.new/@tanstack/vue-start@8294

      @tanstack/vue-start-client

      npm i https://pkg.pr.new/@tanstack/vue-start-client@8294

      @tanstack/vue-start-server

      npm i https://pkg.pr.new/@tanstack/vue-start-server@8294

      @tanstack/zod-adapter

      npm i https://pkg.pr.new/@tanstack/zod-adapter@8294

      commit: 0082cc2

    9. Merging this PR will improve performance by 4.14%

      1 warning, 1 note

      :warning: 48 benchmarks are dominated by system calls

      System calls cannot be simulated consistently and are left out of the measure. The reported value understates the real cost. Switch to the Walltime instrument to measure them.

      Learn more about system calls

      See affected benchmarks

      :information_source: 3 benchmarks have no flamegraph

      The flamegraph wasn't generated: most of the time was spent in runtime internals, which would leave nothing useful to analyze.

      See affected benchmarks

      ⚡ 2 improved benchmarks ✅ 192 untouched benchmarks ⏩ 3 skipped benchmarks1

      Performance Changes

      ModeBenchmarkBASEHEADEfficiency
      ⚡Memorymem client preload-churn (solid)76.7 KB73.4 KB+4.55%
      ⚡Memorymem server error-paths redirect (react)13.9 KB13.4 KB+3.73%

      Tip

      Curious why performance improved? Comment @codspeedbot explain why performance improved on this PR, or directly use the CodSpeed MCP with your agent.


      Comparing feat/start-route-sitemaps (0082cc2) with feat/start-prerender-params (35c7c97) Open in CodSpeed

      Footnotes

      1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

    10. 🦋 Changeset detected

      Latest commit: 0082cc297f59544b24bccfddab9185d7220dea85

      The changes in this PR will be included in the next version bump.

      This PR includes changesets to release 14 packages
      NameType
      @tanstack/start-client-coreMinor
      @tanstack/start-plugin-coreMinor
      @tanstack/react-start-clientPatch
      @tanstack/react-start-rscPatch
      @tanstack/react-startPatch
      @tanstack/solid-start-clientPatch
      @tanstack/solid-startPatch
      @tanstack/start-server-corePatch
      @tanstack/start-static-server-functionsPatch
      @tanstack/vue-start-clientPatch
      @tanstack/vue-startPatch
      @tanstack/react-start-serverPatch
      @tanstack/solid-start-serverPatch
      @tanstack/vue-start-serverPatch

      Not sure what this means? Click here to learn what changesets are.

      Click here if you're a maintainer who wants to add another changeset to this PR

Sign in to join this conversation.