docs(router): clarify static title fallback in SPA mode

Aperta Adatta ai principianti
#8,840 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@Rohan-Dedhia ci sta già lavorando.

Dal 4/11/2026.

  • #8873 di @Rohan-Dedhia — aperta

Valutazione

Difficoltà
1/5
Tempo stimato
1-3 ore
Idoneità per principianti
62/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
html, react, typescript
Ambito
documentation

Direzione di ricerca

La guida è la pagina sull'head del documento SPA nella documentazione di TanStack Router, dove compare l'istruzione di rimuovere il <title> statico da index.html insieme a <HeadContent />. Leggi quella sezione, poi la discussione collegata #1056 per il contesto precedente sui titoli delle route. È completata quando la documentazione spiega perché il titolo statico va eliminato, come appare l'HTML iniziale senza di esso, e raccomanda prerendering o SSR per i metadati specifici delle route, con uno schema di fallback supportato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

What would you like to see?

The SPA document head guide says to remove the static <title> from index.html when using <HeadContent />. It would help to explain why this is necessary and what to do if the app still needs a fallback title before JavaScript runs.

In SPA mode, the initial HTML response is the same for every route, so route-specific metadata is only available after the router runs. A static title can provide a useful fallback, but HeadContent currently doesn't adopt or replace that unmanaged title, so leaving it in place can result in duplicate titles.

Could the docs clarify this trade-off and recommend prerendering or SSR when route-specific metadata needs to be present in the initial HTML? It would also be useful to mention a supported pattern for retaining a generic fallback title without leaving duplicate title elements after the app starts.

Why is this needed?

Some apps don't need search indexing, but still want a sensible browser-tab title if JavaScript is disabled, blocked, or fails to load. The current instruction to remove the title is easy to follow without realizing that the initial document then has no title until client-side rendering.

I found the existing discussion about route titles: https://github.com/TanStack/router/discussions/1056

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

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.