0
Fork 0
mirror of https://github.com/TanStack/router.git synced 2026-11-16 19:38:07 +00:00
Commit graph

306 commits

Author SHA1 Message Date
Tanner Linsley
05422da535
docs(start): correct authentication server function examples (#8368)
* docs(start): correct authentication server function examples

* docs(start): prevent caching session-specific auth pages

* docs(start): guard login forms until hydration

* test(start): assert authentication behavior in SSR and SPA modes
2026-09-11 17:22:55 -06:00
Tanner Linsley
3487cf0451
docs(start): redirect obsolete Solid tutorial path (#8379) 2026-09-11 17:14:55 -06:00
Tanner Linsley
0b152a7b5e
docs(start): add production release checklist (#8373)
* docs(start): add production release checklist

* docs(start): clarify authenticated CSRF and cache checks
2026-09-11 17:14:04 -06:00
Tanner Linsley
e047e3f7ca
docs(start): add tested TanStack Query integration guide (#8372)
* docs(start): add tested TanStack Query integration guide

* fix(examples): protect Query server functions from cross-site calls
2026-09-11 17:13:58 -06:00
Tanner Linsley
c6c282b786
docs(start): distinguish authentication page titles (#8378) 2026-09-11 17:12:52 -06:00
Tanner Linsley
dbf0bd9582
docs(start): add a tested Next.js migration reference (#8371)
* docs(start): add a tested Next.js migration reference

* fix(examples): serialize migration save and sign-out actions

* fix(examples): verify authenticated cross-site mutation rejection
2026-09-11 17:12:47 -06:00
Tanner Linsley
83b2199b4c
docs(start): substantiate framework comparison claims (#8369) 2026-09-11 15:06:24 -06:00
Tanner Linsley
d48ae42b85
docs(start): describe key search entry pages (#8367) 2026-09-11 14:47:42 -06:00
Tanner Linsley
931fae487e
docs(start): fix tutorial and ISR guide links (#8366)
* docs(start): fix broken createServerFn doc links in reading-writing-file tutorials

The 'server-functions' page moved from /framework/{react,solid}/server-functions
to /framework/{react,solid}/guide/server-functions in a recent docs refactor.
The old URL returns 307 redirects that hang (tanstack.com server is
timing out on these paths) — effectively a 404 from the user perspective.

Verified manually: the new /guide/server-functions path returns 200 for
both react and solid variants. The link text in the tutorial points to
'createServerFn', which is documented on the new page.

* docs(start): fix ISR data loading link

---------

Co-authored-by: sanjibani <18418553+sanjibani@users.noreply.github.com>
2026-09-11 14:36:09 -06:00
EduardF1
d91b383b8f
docs(start): fix broken routing-side guide link in authentication primitives (#7701) (#7705)
docs(start): fix broken routing-side guide link in authentication primitives

The "routing-side guide" links in the Authentication Server Primitives guide
used a relative path (`../../../../router/guide/authenticated-routes.md`).
While that resolves as a file path, it renders to an invalid site URL
(`/start/latest/router/guide/authenticated-routes`) and 404s.

Use the absolute cross-project doc path that the rest of the docs already use
for Router links, e.g. `/router/latest/docs/framework/react/guide/authenticated-routes`.

Closes #7701

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-09-11 14:34:50 -06:00
Kevin Van Cott
3b27db6c38
docs: remove duplicate Router and Start page headings (#8339) 2026-09-10 12:32:59 +02:00
Jiahan Chen
aab01dec75
chore(start): remove redundant splitChunks config from React plugin (#8136) 2026-08-22 09:48:38 +02:00
Sarah Gerrard
a76c192f1c
docs: Update Guides section and add back in missing pages (#7864) 2026-07-22 22:13:55 +02:00
Cong-Cong Pan
21a8597952
chore: add React Start basic Rsbuild example (#7729)
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-07-22 22:09:03 +02:00
Alex Kostyniuk
31a634d84e
docs: update Next.js middleware description (#6155)
* docs: update Next.js middleware description

* Fix grammar in Next.js Edge Runtime description

Correct grammatical error in comparison of Next.js limitations.

* Revise Next.js proxy.ts runtime details

Updated Next.js proxy.ts description to reflect runtime changes.

* removed the not needed '+'

---------

Co-authored-by: Sarah Gerrard <hello@sarahgerrard.me>
2026-07-17 18:19:11 -07:00
Mohamed Yahye El Joud
00d00b3155
docs: Update environment variable validation to use z.url() (#5570) 2026-07-17 20:47:19 +02:00
Florian Fehrenbacher
4d4171fdda
fix: use relative path for srvx static files (#7799) 2026-07-13 23:38:26 +02:00
Flo
ac821f40aa
docs(start): clarify server functions vs server routes (#7651)
* docs(start): clarify server functions and routes usage

* clean up repetition
2026-06-18 12:49:10 +02:00
Tanner Linsley
6f882b7dae
docs(start): rename LLM optimization guide to GEO (#7620) 2026-06-12 11:24:22 -06:00
Manuel Schiller
9bebf8dc9f
rename inputValidator to validator (#7566)
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-06-06 23:05:56 +02:00
Tanner Linsley
ccf87fbe6f
docs: clarify auth data boundaries (#7537) 2026-06-03 12:48:48 -06:00
Manuel Schiller
54b0d9a91e
docs (#7521) 2026-06-01 22:05:37 +02:00
Manuel Schiller
e51ad23c0f
docs (#7520) 2026-06-01 21:46:55 +02:00
Manuel Schiller
51a97a167f
feat(start): support rsbuild iife client output (#7477) 2026-05-24 02:02:05 +02:00
Tanner Linsley
0bfb7efa12
docs(start): compare deferred hydration to React selective hydration (#7442)
Adds a short comparison section answering the common question about how
TanStack Start's deferred hydration relates to React 18's selective
hydration. The framing: selective hydration controls the order of
inevitable hydration work; deferred hydration controls whether and when
that work happens at all.
2026-05-19 19:44:44 -06:00
Tanner Linsley
ac4b43f346
docs(start): compare deferred hydration to Astro islands (#7438)
Adds a short mental-model section answering the common question
about how TanStack Start's deferred hydration relates to Astro
islands.
2026-05-19 15:09:21 -06:00
Manuel Schiller
5fa9e555f3
feat: deferred hydration (#7362)
* feat: deferred hydration

* fix

* tests

* solid tests

* Changes before error encountered

Agent-Logs-Url: https://github.com/TanStack/router/sessions/5263c469-75c2-4470-bd4c-86f9b43964f4

Co-authored-by: schiller-manuel <6340397+schiller-manuel@users.noreply.github.com>

* chore: address hydration review follow-ups

Agent-Logs-Url: https://github.com/TanStack/router/sessions/16e27113-ff01-4de8-aded-b9be9f6dd4ff

Co-authored-by: schiller-manuel <6340397+schiller-manuel@users.noreply.github.com>

* fix(start-client-core): correct import order in hydrateStart.ts

Co-authored-by: schiller-manuel <schiller-manuel@users.noreply.github.com>

* chore: remove tracked nx self-healing artifacts

Agent-Logs-Url: https://github.com/TanStack/router/sessions/95750760-1348-437c-8f73-cc45e899003a

Co-authored-by: schiller-manuel <6340397+schiller-manuel@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: schiller-manuel <6340397+schiller-manuel@users.noreply.github.com>
Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
Co-authored-by: schiller-manuel <schiller-manuel@users.noreply.github.com>
2026-05-19 18:43:00 +02:00
Sean Cassiere
2506478fa8
docs(start): use router package for module declaration to type the request context (#7427) 2026-05-18 10:29:25 +12:00
Manuel Schiller
2387a2eea0
feat(start): add inline CSS runtime controls and asset URL templates (#7380) 2026-05-16 00:38:42 +02:00
Flo
5ae2ae5e0f
feat(start): CSRF middleware (#7373) 2026-05-09 18:34:24 +02:00
Copilot
4eed408f12
Document server function strict serialization options (#7358)
* Document server function strict option

Agent-Logs-Url: https://github.com/TanStack/router/sessions/8deabe7a-7412-455e-9111-97a13cb4582e

Co-authored-by: schiller-manuel <6340397+schiller-manuel@users.noreply.github.com>

* Refine strict docs wording

Agent-Logs-Url: https://github.com/TanStack/router/sessions/e2857d6e-314e-496c-b99b-78c207c28c77

Co-authored-by: schiller-manuel <6340397+schiller-manuel@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: schiller-manuel <6340397+schiller-manuel@users.noreply.github.com>
2026-05-07 03:19:26 +02:00
Tanner Linsley
3526194849
docs(skills): address 8 agent failure modes from user feedback (#7314)
* docs(skills): address 8 agent failure modes from external feedback

Adds new start-core/auth-server-primitives skill (sessions, cookies,
OAuth+PKCE, password-reset enumeration defense, CSRF, rate limiting,
session rotation) and updates 8 existing skills + matching docs to fix
patterns where agents produce insecure or wrong-framework output.

Skill changes:
- new: start-core/auth-server-primitives (server half of auth)
- router-core/auth-and-guards: route guard != RPC guard
- start-core/server-functions: wrong import path, RPC auth required,
  Cache-Control public is a cross-tenant leak, wrong-framework patterns
- start-core/middleware: wrong import path, sendContext shape vs access
  (3-layer wrong/still-wrong/correct), authMiddleware framing
- start-core/execution-model: file markers (server-only/client-only),
  module-level process.env is undefined under Worker SSR
- start-core/deployment: cloudflare env-at-request-time
- router-core/ssr: wrong file structures (next.js, react-router-dom)
- router-core/type-safety: wrong-framework imports + structures

Docs updated to mirror each skill change so source-of-truth and the
intent-indexed skill stay in sync. New authentication-server-primitives
guide is the long-form companion to the new skill.

intent validate: 30 skill files pass (was 29).

* ci: apply automated fixes

* docs(skills): address coderabbit review feedback

- Fix internal docs links to use correct relative paths instead of an
  absolute /start/latest/... URL and missing one ../ segment
- Remove blank line inside auth-and-guards blockquote (markdownlint MD028)
- Restore overload pattern in type-safety ValidateNavigateOptions and
  ValidateRedirectOptions examples; the casts I had introduced stripped
  generic context and contradicted the skill's own no-cast rule
- Add db.sessions.revokeAllForUser before create in login rotation
  snippets so the example matches the prose
- Soften useServerFn guidance: it's required only when the server
  function throws redirect/notFound; plain-data calls work directly and
  via useMutation/useQuery

* ci: apply automated fixes

* docs(skills): compress type-safety to stay under 500-line cap

Prettier's autofix expanded my single-line overload signatures across
multiple lines, pushing the file over the 500-line limit. Drop the
redundant fetchOrRedirect example (same pattern as useDelayedNavigate)
and describe ValidateRedirectOptions usage in prose instead.

* docs(skills): CSRF origin check should compare full origin, not host alone

Comparing only new URL(origin).host against APP_HOST silently accepts a
mismatched scheme — http://example.com would pass a check meant for
https://example.com. Compare the full origin (scheme + host + port)
against APP_ORIGIN instead. Same fix in skill and docs.

* docs(skills): make useDelayedNavigate callback truly return void

The callback returned the result of setTimeout (a timer handle), not
void as the public overload's return type implied. Wrap in a block so
the example matches the declared return type.

Skipped the related nitpick to add a separate redirect example — the
existing prose already describes the same overload pattern, and a
duplicate example would push the file close to the 500-line cap that
prettier autofix has been bumping us against.

* docs(skills): fix two real bugs in auth-server-primitives examples

1. Cookie parser truncated values containing '='. Signed cookies, JWTs,
   and base64-padded values all use '='. Use indexOf to split on the
   FIRST '=' only.

2. Login example short-circuited verifyPasswordHash on user-not-found,
   contradicting the prose's "same time, same error" claim — the
   no-user branch returned instantly while wrong-password spent ~100ms
   hashing, leaking account existence over the wire. Always verify
   against a hash; use a precomputed DUMMY_PASSWORD_HASH when the user
   is missing, then combine with the user-exists bit for the final ok.

Same fixes in the SKILL.md and the docs companion.

* docs(skills): address manuel's review on react-specific guides

- middleware.md, server-functions.md: drop cross-framework <framework>
  placeholders; this is the React-specific guide, just say
  @tanstack/react-start
- execution-model.md: drop the same trailing line about solid-start /
  vue-start paths
- hosting.md: remove the Cloudflare env-handling subsection — the
  general per-request rule lives in environment-variables.md and
  doesn't need to be repeated under a specific host
- environment-variables.md: mention the cloudflare:workers env binding
  as the canonical Cloudflare way to read env (including module scope),
  per Manuel's link to the Cloudflare docs
- deployment skill: same upgrade — show the cloudflare:workers env
  pattern alongside the per-request handler approach

* docs(skills): drop redundant server-only marker in session example

The file already imports from @tanstack/react-start/server, which is
on import protection's default client-deny specifier list. The
side-effect marker is redundant — drop it. Same fix in skill and docs.

* docs(skills): drop wrong-import-path mistakes — TS already catches them

Manuel pointed out that TypeScript catches both common wrong paths:
'@tanstack/react-router' has no exported member createServerFn /
createMiddleware, and '@tanstack/start' is "Cannot find module". Skill
space is precious; the items don't earn their slot if tsc handles them.

Removed:
- Common Mistake "Wrong import path" from server-functions and
  middleware skills (renumbered the remaining mistakes)
- The matching top-of-file CRITICAL line in both skills
- The "Import path" callouts in the middleware and server-functions
  docs

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-05-02 23:11:30 -06:00
Manuel Schiller
709627f3db
feat: Link header (#7327)
Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
2026-05-03 01:25:30 +02:00
Manuel Schiller
238ea4a499
feat: early hints (#7324) 2026-05-02 23:35:52 +02:00
Abhishek Raj
d2e8c2aba2
docs: Improve key differences b/w Start Server Functions and Next.js Server Actions (#7312) 2026-05-02 00:16:31 +02:00
Manuel Schiller
c4256c2c85
fix: Ignore fully type-only imports and re-exports when collecting im… (#7305)
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-04-30 22:37:53 +02:00
Abhishek Raj
66dbff6587
docs: Fix server function middleware prop (#7262) 2026-04-25 22:15:20 +02:00
Manuel Schiller
91a708989d
rsbuild plugin (#7228)
Co-authored-by: neverland <chenjiahan.jait@bytedance.com>
Co-authored-by: Keven Arroyo <dake.3601@gmail.com>
2026-04-24 03:26:03 +02:00
Mukunda Rao Katta
3a59b7203a
docs(start): add missing space after comma in 'Handling requests with a body' (#7234) 2026-04-21 21:36:46 +02:00
Pavan Shinde
e2332b0c08
docs(start): fix authenticated routes doc URL (#7214) 2026-04-17 19:39:32 +02:00
MoonBrillante
f1a4973d41
fix(docs): correct server function name in example (#7173) 2026-04-13 23:29:07 +02:00
Manuel Schiller
f920527e8d
efp (#7144)
Co-authored-by: Tanner Linsley <tannerlinsley@gmail.com>
2026-04-11 01:43:05 +02:00
Tanner Linsley
24cc08f87e docs(start): merge quick start into getting started
Put Start project setup in a single onboarding path for React and Solid while preserving old quick-start URLs with redirects.
2026-04-09 16:13:07 -06:00
Adam Rackis
6ad41eaf64
Docs tweaks for pre-rendering (#6612)
docs tweaks
2026-04-09 11:13:40 -06:00
Anton Ödman
1f41bc531d
docs: update migrate from next docs to working example (#7025)
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-03-24 23:54:00 +01:00
Aditya Vyas
2e8d89fdb2
docs(start): fix the broken logo urls for Railway in the hosting guide (#7015) 2026-03-25 10:22:39 +13:00
Manuel Schiller
6164816414
feat: transformAssets (#7009)
* feat: transformAssets

replaces transformAssetUrls

* fix

* fix
2026-03-22 20:25:12 +01:00
Antony Garand
80de7a9cd7
Tanstack start docs: fix nodejs link for bun (#6992) 2026-03-20 10:51:12 +01:00
Ahmed Zougari
8d9988a054
docs: update the scratch guide to be compatible with Vite 8 (#6976) 2026-03-19 02:38:54 +01:00
Birk Skyum
75686c6123
docs: add tutorial section for solid (#6961) 2026-03-17 23:29:59 +01:00