Server Components: RSC client runtime lands in the shared entry chunk even when one route uses it

Aperta
#8,941 1 commento 1 reazione 2 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@schiller-manuel ci sta già lavorando.

Dal 15/11/2026.

  • #8942 di @schiller-manuel — aperta

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

Versions

  • @tanstack/react-start 1.169.5, @tanstack/react-router 1.170.46, @tanstack/react-start-rsc 0.1.66
  • @vitejs/plugin-rsc 0.5.39, Vite 8 (Vite+ core 1.5.0), React 19.3.1, production build

What happens

With tanstackStart({ rsc: { enabled: true } }) and rsc(), one route that calls renderServerComponent(<p>…</p>) from a server function adds the RSC client runtime to the shared entry chunk, so every route pays for it, not only the route that uses Server Components.

Same app and sources, before and after adding that one route (vite build --sourcemap, bytes attributed per source file through the maps):

before after
all client JS, raw 1,663,509 B 1,674,859 B (+11,350)
all client JS, gzip 554,604 B 560,321 B (+5,717)
shared index chunk, raw 303,755 B 329,464 B
shared index chunk, gzip 96,334 B 104,493 B (+8.2 kB)

Sources in the index chunk afterwards include @tanstack/react-start-rsc/dist/esm/rscCssEnvelope.js, reactSymbols.js, awaitLazyElements.js and ServerComponentTypes.js; @vitejs/plugin-rsc accounts for about 19 kB raw.

Expectation

For an app that adopts Server Components on a few routes, I'd expect the Flight client runtime to load with those routes' chunks (or lazily on first use), not in the entry chunk. Is that something that can be code-split today, for example through the route's lazy chunk, or is the entry chunk the intended place? If it is intended, a note in the Server Components guide about the fixed client cost would help people size the trade-off.

Lingua principale
TypeScript
Stelle
15.3k
Fork
1.9k
Merge medio
1g 5h
PR unite (30g)
46

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di TanStack/router

Tutte le issue di TanStack/router

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.