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

Ouverte
#8,941 1 commentaire 1 réaction 2 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@schiller-manuel y travaille déjà.

Depuis le 15/11/2026.

  • #8942 par @schiller-manuel — ouverte

Évaluation

Cette issue n'a pas encore été évaluée.

Description

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.

Langage dominant
TypeScript
Étoiles
15.3k
Forks
1.9k
Merge moyen
1 j 5 h
PR mergées (30 j)
46

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de TanStack/router

Toutes les issues de TanStack/router

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.