Skip to content
Source
Sign inSign up
TanStack/router

perf(start-plugin-core): build Start compiler-generated code directly instead of parsing it #8680

OpenSheraff(GitHub profile, opens in a new tab)wants to merge 10 commits intoperf/copy-free-outputs fromperf/direct-builders-propened

Stacked on #8675.

The Start compiler inserts small, fixed pieces of code: server function RPC calls and handlers, env-only and isomorphic stubs, Hydrate imports and boundaries, RSC CSS options, and import protection mocks. Today it prints each piece as a string and parses it again. This PR builds those nodes directly with yuku-ast builders.

  • One commit per transform, so each can be reviewed or dropped on its own.
  • 795555c13b (Hydrate boundary child and preload prop) is included because the Hydrate lazy-import commit depends on it.
  • Compiler output is byte-identical to #8675: 376 Start outputs and 2,928 code-splitter outputs (code and source maps).
  • Out of scope: the route HMR and React Refresh snippets, and handleRouteUpdate. Those are being explored separately.

Performance

Measured against #8675, 10 alternating pairs, one benchmark at a time:

WorkloadTimePeak RSS
1,000 server functions, whole build−8.9%
5,000 server functions, whole build−9.1%1,088 → 1,002 MiB
Server function compiler passes (SSR, provider, dev)−18% to −32%
Env-only / isomorphic stubs−20%−6%
Hydrate−16%−5%
RSC CSS−31%−19%
Import protection rewrite−50%−30%
Start server-functions e2e app build−1.1%−1.9%
Start deferred-hydration e2e app build−2.1%within noise

Written with Claude Code (AI-assisted).

✅ 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).

🤖 Generated with Claude Code

    1. 🦋 Changeset detected

      Latest commit: b119fd79281f6d3e5dbfbe30a241f258979bd711

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

      This PR includes changesets to release 5 packages
      NameType
      @tanstack/start-plugin-corePatch
      @tanstack/react-start-rscPatch
      @tanstack/react-startPatch
      @tanstack/solid-startPatch
      @tanstack/vue-startPatch

      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

    2. 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
      • Configuration used: Repository: TanStack/router/.coderabbit.yaml
      • Review profile: CHILL
      • Plan: Advanced
      • Run ID: 6a7aace9-6f69-48fe-bbba-c5afdc79713b

      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.
    3. github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: start-plugin-core

    4. github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: react-start-rsc

    5. View your CI Pipeline Execution ↗ for commit b119fd79281f6d3e5dbfbe30a241f258979bd711

      CommandStatusDurationResult
      nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded22m 25sView ↗
      nx run-many --target=build --exclude=examples/*...✅ Succeeded42sView ↗

      ☁️ Nx Cloud last updated this comment at 2026-10-11 20:47:51 UTC

    6. 🚀 Changeset Version Preview

      7 package(s) bumped directly, 3 bumped as dependents.

      🟨 Minor bumps

      PackageVersionReason
      @tanstack/router-cli1.167.41 → 1.168.0Changeset
      @tanstack/router-generator1.167.41 → 1.168.0Changeset
      @tanstack/router-plugin1.168.43 → 1.169.0Changeset
      @tanstack/router-utils1.162.3 → 1.163.0Changeset
      @tanstack/router-vite-plugin1.167.43 → 1.168.0Changeset
      @tanstack/start-plugin-core1.171.50 → 1.172.0Changeset

      🟩 Patch bumps

      PackageVersionReason
      @tanstack/react-start-rsc0.1.60 → 0.1.61Changeset
      @tanstack/react-start1.168.61 → 1.168.62Dependent
      @tanstack/solid-start1.168.58 → 1.168.59Dependent
      @tanstack/vue-start1.168.57 → 1.168.58Dependent
    7. Bundle Size Benchmarks

      This pull request does not affect bundle size in any measured scenario.

    8. More templates

      @tanstack/arktype-adapter

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

      @tanstack/eslint-plugin-router

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

      @tanstack/eslint-plugin-start

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

      @tanstack/history

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

      @tanstack/nitro-v2-vite-plugin

      npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@8680

      @tanstack/react-router

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

      @tanstack/react-router-devtools

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

      @tanstack/react-router-ssr-query

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

      @tanstack/react-start

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

      @tanstack/react-start-client

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

      @tanstack/react-start-rsc

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

      @tanstack/react-start-server

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

      @tanstack/router-cli

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

      @tanstack/router-core

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

      @tanstack/router-devtools

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

      @tanstack/router-devtools-core

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

      @tanstack/router-generator

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

      @tanstack/router-plugin

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

      @tanstack/router-ssr-query-core

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

      @tanstack/router-utils

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

      @tanstack/router-vite-plugin

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

      @tanstack/solid-router

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

      @tanstack/solid-router-devtools

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

      @tanstack/solid-router-ssr-query

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

      @tanstack/solid-start

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

      @tanstack/solid-start-client

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

      @tanstack/solid-start-server

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

      @tanstack/start-client-core

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

      @tanstack/start-fn-stubs

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

      @tanstack/start-plugin-core

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

      @tanstack/start-server-core

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

      @tanstack/start-static-server-functions

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

      @tanstack/start-storage-context

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

      @tanstack/valibot-adapter

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

      @tanstack/virtual-file-routes

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

      @tanstack/vue-router

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

      @tanstack/vue-router-devtools

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

      @tanstack/vue-router-ssr-query

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

      @tanstack/vue-start

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

      @tanstack/vue-start-client

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

      @tanstack/vue-start-server

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

      @tanstack/zod-adapter

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

      commit: b119fd7

    9. Merging this PR will degrade performance by 3.84%

      :information_source: 33 benchmarks have no flame graph

      The flamegraph could not be generated because too much time was spent in runtime internals, making the visualization not useful for performance analysis.

      ❌ 2 regressed benchmarks ✅ 192 untouched benchmarks ⏩ 3 skipped benchmarks1

      Warning

      Please fix the performance issues or acknowledge them on CodSpeed.

      Performance Changes

      ModeBenchmarkBASEHEADEfficiency
      ❌Memorymem server error-paths not-found (vue)123.9 KB129.2 KB-4.1%
      ❌Memorymem server aborted-requests (vue)100.4 KB104.1 KB-3.57%

      Tip

      Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.


      Comparing perf/direct-builders-pr (b119fd7) with perf/copy-free-outputs (5242532) 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. ↩

Sign in to join this conversation.