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

Abierto
#8,941 1 comentario 1 reacción 2 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@schiller-manuel ya está trabajando en esto.

Desde el 15/11/2026.

  • #8942 de @schiller-manuel — abierto

Evaluación

Este issue todavía no se ha evaluado.

Descripción

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.

Lenguaje dominante
TypeScript
Estrellas
15.3k
Forks
1.9k
Merge medio
1 d 5 h
PR fusionados (30 d)
46

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de TanStack/router

Todos los issues de TanStack/router

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.