perf(start-plugin-core): build Start compiler-generated code directly instead of parsing it #8680
perf/copy-free-outputs fromperf/direct-builders-pr·opened 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:
| Workload | Time | Peak 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
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.yamlfile in this repository. To trigger a single review, invoke the@coderabbitai reviewcommand.⚙️ 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_statustofalsein 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.
Comment `@coderabbitai help` to get the list of available commands.-
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: start-plugin-core
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: react-start-rsc
View your CI Pipeline Execution ↗ for commit b119fd79281f6d3e5dbfbe30a241f258979bd711
Command Status Duration Result nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded 22m 25s View ↗ nx run-many --target=build --exclude=examples/*...✅ Succeeded 42s View ↗
☁️ Nx Cloud last updated this comment at
2026-10-11 20:47:51UTC🚀 Changeset Version Preview#
7 package(s) bumped directly, 3 bumped as dependents.
🟨 Minor bumps#
Package Version Reason @tanstack/router-cli1.167.41 → 1.168.0 Changeset @tanstack/router-generator1.167.41 → 1.168.0 Changeset @tanstack/router-plugin1.168.43 → 1.169.0 Changeset @tanstack/router-utils1.162.3 → 1.163.0 Changeset @tanstack/router-vite-plugin1.167.43 → 1.168.0 Changeset @tanstack/start-plugin-core1.171.50 → 1.172.0 Changeset 🟩 Patch bumps#
Package Version Reason @tanstack/react-start-rsc0.1.60 → 0.1.61 Changeset @tanstack/react-start1.168.61 → 1.168.62 Dependent @tanstack/solid-start1.168.58 → 1.168.59 Dependent @tanstack/vue-start1.168.57 → 1.168.58 Dependent Bundle Size Benchmarks#
This pull request does not affect bundle size in any measured scenario.
More templates
- tanstack-router-react-example-authenticated-routes
- tanstack-router-react-example-authenticated-routes-firebase
- tanstack-router-react-example-basic
- tanstack-router-react-example-basic-default-search-params
- tanstack-router-react-example-basic-devtools-panel
- tanstack-router-react-example-basic-file-based
- tanstack-router-react-example-basic-non-nested-devtools
- tanstack-router-react-example-react-query
- tanstack-router-react-example-basic-react-query-file-based
- tanstack-router-react-example-basic-ssr-file-based
- tanstack-router-react-example-basic-ssr-streaming-file-based
- tanstack-router-react-example-basic-virtual-file-based
- tanstack-router-react-example-basic-virtual-inside-file-based
- tanstack-router-react-example-deferred-data
- tanstack-router-i18n-paraglide
- tanstack-router-react-example-kitchen-sink
- tanstack-router-react-example-kitchen-sink-file-based
- tanstack-router-react-example-kitchen-sink-react-query
- tanstack-router-react-example-kitchen-sink-react-query-file-based
- tanstack-router-react-example-large-file-based
- tanstack-router-react-example-location-masking
- tanstack-router-react-example-navigation-blocking
- tanstack-router-react-example-quickstart
- tanstack-router-react-example-quickstart-esbuild-file-based
- tanstack-router-react-example-quickstart-file-based
- tanstack-router-react-example-quickstart-rspack-file-based
- tanstack-router-react-example-quickstart-webpack-file-based
- router-monorepo-react-query
- router-mono-simple
- router-mono-simple-lazy
- tanstack-router-react-example-scroll-restoration
- tanstack-search-validator-adapters
- tanstack-start-example-bare
- tanstack-start-example-basic
- tanstack-start-example-basic-auth
- tanstack-router-react-example-basic-authjs
- tanstack-start-example-basic-cloudflare
- tanstack-start-example-basic-react-query
- tanstack-start-example-basic-rsbuild
- tanstack-start-example-basic-static
- tanstack-start-bun-hosting
- tanstack-start-example-clerk-basic
- tanstack-start-example-convex-trellaux
- tanstack-start-example-counter
- tanstack-start-i18n-paraglide
- tanstack-start-example-large
- tanstack-start-example-material-ui
- tanstack-start-example-next-migration
- tanstack-start-example-rscs
- tanstack-start-streaming-data-from-server-functions
- tanstack-start-example-supabase-basic
- tanstack-start-tailwind-v4
- tanstack-start-example-trellaux
- tanstack-start-example-workos
- tanstack-router-react-example-view-transitions
- tanstack-router-react-example-with-framer-motion
- tanstack-router-react-example-with-trpc
- tanstack-router-react-example-with-trpc-react-query
- tanstack-router-vue-example-basic-jsx
- tanstack-router-vue-example-basic-file-based-jsx
- tanstack-router-vue-example-basic-file-based-sfc
- tanstack-router-solid-example-authenticated-routes
- tanstack-router-solid-example-authenticated-routes-firebase
- tanstack-router-solid-example-basic
- tanstack-router-solid-example-basic-default-search-params
- tanstack-router-solid-example-basic-devtools-panel
- tanstack-router-solid-example-basic-file-based
- tanstack-router-solid-example-basic-non-nested-devtools
- tanstack-router-solid-example-basic-solid-query
- tanstack-router-solid-example-basic-solid-query-file-based
- tanstack-router-solid-example-basic-ssr-file-based
- tanstack-router-solid-example-basic-ssr-streaming-file-based
- tanstack-router-solid-example-basic-virtual-file-based
- tanstack-router-solid-example-basic-virtual-inside-file-based
- tanstack-router-solid-example-deferred-data
- tanstack-router-solid-i18n-paraglide
- tanstack-router-solid-example-kitchen-sink
- tanstack-router-solid-example-kitchen-sink-file-based
- tanstack-router-solid-example-kitchen-sink-solid-query
- tanstack-router-solid-example-kitchen-sink-solid-query-file-based
- tanstack-router-solid-example-large-file-based
- tanstack-router-solid-example-location-masking
- tanstack-router-solid-example-navigation-blocking
- tanstack-router-solid-example-quickstart
- tanstack-router-solid-example-quickstart-esbuild-file-based
- tanstack-router-solid-example-quickstart-file-based
- tanstack-router-solid-example-quickstart-rspack-file-based
- tanstack-router-solid-example-quickstart-webpack-file-based
- @tanstack/router-solid-mono-simple
- router-solid-mono-simple-lazy
- router-solid-monorepo-solid-query
- tanstack-router-solid-example-scroll-restoration
- tanstack-solid-router-search-validator-adapters
- tanstack-solid-start-example-basic
- tanstack-solid-start-example-basic-auth
- tanstack-solid-start-example-basic-authjs
- tanstack-solid-start-example-basic-cloudflare
- tanstack-solid-start-example-basic-netlify
- tanstack-solid-start-example-basic-nitro
- tanstack-start-example-basic-solid-query
- tanstack-solid-start-example-basic-static
- tanstack-solid-start-bun-hosting
- tanstack-solid-start-example-convex-better-auth
- tanstack-solid-start-example-counter
- tanstack-solid-start-i18n-paraglide
- tanstack-solid-start-example-large
- tanstack-solid-start-streaming-data-from-server-functions
- tanstack-solid-start-example-supabase-basic
- tanstack-solid-start-tailwind-v4
- tanstack-router-solid-example-view-transitions
- tanstack-router-solid-example-with-framer-motion
- tanstack-router-solid-example-with-trpc
@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@8680commit:
b119fd7Merging 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.
ssr loaders (react)client-links navigation loop (solid)ssr selective (react)ssr server-fn during document ssr (react)ssr server-fn redirect (react)ssr server-fn not-found (react)ssr server-fn multipart (react)ssr rewrite localized (react)client-search-params navigation loop (solid)hydrate restored route state and mixed Links (solid)- …and 23 more
❌ 2regressed benchmarks✅ 192untouched benchmarks⏩ 3skipped benchmarks1Warning
Please fix the performance issues or acknowledge them on CodSpeed.
Performance Changes#
Mode Benchmark BASEHEADEfficiency ❌ Memory mem server error-paths not-found (vue)123.9 KB 129.2 KB -4.1% ❌ Memory mem server aborted-requests (vue)100.4 KB 104.1 KB -3.57% Tip
Investigate this regression by commenting
@codspeedbot fix this regressionon this PR, or directly use the CodSpeed MCP with your agent.
Comparingperf/direct-builders-pr(b119fd7) withperf/copy-free-outputs(5242532)Footnotes#
-
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.
🦋 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
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