0
Fork 0
mirror of https://github.com/TanStack/router.git synced 2026-11-16 19:38:07 +00:00
🤖 A client-first, server-capable, fully type-safe router and full-stack framework for the web (React and more). https://tanstack.com/router
  • TypeScript 98.2%
  • JavaScript 1.2%
  • CSS 0.4%
  • Vue 0.1%
  • HTML 0.1%
Find a file
Manuel Schiller 6ddaed9f70 feat(start): experimental Vitest support and typed test helpers
- With `tanstackStart()` in a config that Vitest loads, test files are
  compiled as the app's code is: for the client in browser mode, jsdom
  and happy-dom, for the server in Node. A test run sets up no dev
  server, preview server or build. A project needs no router entry and
  no routes. The route tree is generated once, and route files are never
  written.
- `mockServerFn` and `resetServerFnMocks` in `<framework>-start/testing`:
  in a client test a server function call goes to a mock that is typed
  from the function, in place of a request.
- `runInRequest`, `mockMiddleware` and `runMiddleware` in
  `<framework>-start/testing/server`: a server test runs server functions
  and middleware for a request it describes.
- Mocks end with the test that registered them. The plugin adds a setup
  file to every Vitest project for that.
- In a test run the server finds a server function by its id alone.
  Vitest serves compiled modules from its cache from the second run on,
  so the compiler has no record of them.
- In a test run Start names its packages in `resolve.noExternal` with
  regular expressions. Vitest's translation of the wildcards does not
  match a `-`, so jsdom and Node tests of an installed project ran
  `@tanstack/start-client-core` uncompiled.
- `@tanstack/react-start` pre-bundles `@tanstack/react-store` by a path
  that also resolves from a project that depends on Start only.
- `scripts/e2e/run-as-installed.mjs` runs an e2e project from a
  `pnpm deploy` copy, where `@tanstack/*` are in `node_modules` as in a
  user's project.
- `e2e/react-start/vitest-library` and `e2e/react-start/vitest-app` run
  their tests with an empty Vitest cache, from the warm cache and as an
  installed project.
- Docs: `docs/start/framework/react/guide/testing.md`.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
History 2026-11-15 17:10:33 +01:00
.agents/skills improve bundle size benchmarks and add initial skill (#7450) 2026-06-04 22:48:53 +02:00
.changeset feat(start): experimental Vitest support and typed test helpers 2026-11-15 17:10:33 +01:00
.devcontainer docs: add devcontainer config (#6970) 2026-03-18 15:10:30 +01:00
.github chore(pnpm): upgrade to pnpm 12 (#8912) 2026-11-09 13:24:08 +01:00
.nx ci: upgrade Nx and migrate worker configuration (#8807) 2026-10-25 01:21:10 +02:00
_artifacts docs: use new query methods (#7100) 2026-10-06 17:59:20 +02:00
benchmarks chore(deps): bump @rsbuild/core to 2.3.1 (#8890) 2026-11-08 10:47:24 +01:00
docs feat(start): experimental Vitest support and typed test helpers 2026-11-15 17:10:33 +01:00
e2e feat(start): experimental Vitest support and typed test helpers 2026-11-15 17:10:33 +01:00
examples fix(react-start-rsc): bump RSC bundler deps for RSC (#8919) 2026-11-12 09:33:28 +01:00
gpt chore: use tinyglobby instead of glob (#2880) 2024-11-28 21:28:27 +01:00
media docs: use the dynamic README header endpoint (#7940) 2026-08-03 21:03:29 +02:00
packages feat(start): experimental Vitest support and typed test helpers 2026-11-15 17:10:33 +01:00
scripts feat(start): experimental Vitest support and typed test helpers 2026-11-15 17:10:33 +01:00
skills/bundle-size-optimization ci: keep bundle-size measurement out of the Test workflow (#8669) 2026-10-17 12:35:23 +02:00
.coderabbit.yaml docs: clarify contribution guidelines (#8163) 2026-08-25 05:14:16 +02:00
.gitattributes chore: better build system 2022-01-31 12:06:06 -07:00
.gitignore chore: update nx to 23.2.0 (#8341) 2026-09-10 18:28:24 +02:00
.npmrc ci: move pnpm settings to pnpm-workspace.yaml (#6076) 2025-12-12 15:25:17 +11:00
.nvmrc chore: update Node.js to 26.12.1 (#8779) 2026-10-21 19:28:23 +02:00
.prettierignore fix: harden URL handling across Router and Start (#8308) 2026-09-09 23:03:49 +02:00
AGENTS.md ci: upgrade Nx and migrate worker configuration (#8807) 2026-10-25 01:21:10 +02:00
CONTRIBUTING.md add AI rules to CONTRIBUTING.md (#8714) 2026-10-14 17:40:27 +02:00
DEBUGGING.md feat: optional path params (#4597) 2025-07-16 13:41:58 -06:00
eslint.config.js test: migrate lint from tanstack/config to tanstack/eslint-config (#6915) 2026-03-13 03:02:00 +01:00
how-to-guides-implementation-plan.md docs: search param sharing/inheritance how-to 2025-07-30 11:09:18 -06:00
how-to-testing-plan.md ci: apply automated fixes 2025-07-28 19:18:28 +00:00
knip.json chore: Migrate to ESLint flat config (#1846) 2024-06-28 11:59:39 +10:00
labeler-config.yml chore: remove experimental Nitro v2 Vite plugin (#8537) 2026-10-13 00:42:07 +02:00
LICENSE Update outdated LICENSE year (#335) 2022-11-10 08:49:28 -07:00
nx.json ci: upgrade Nx and migrate worker configuration (#8807) 2026-10-25 01:21:10 +02:00
package.json chore(pnpm): upgrade to pnpm 12 (#8912) 2026-11-09 13:24:08 +01:00
pnpm-lock.yaml feat(start): experimental Vitest support and typed test helpers 2026-11-15 17:10:33 +01:00
pnpm-workspace.yaml fix(react-start-rsc): bump RSC bundler deps for RSC (#8919) 2026-11-12 09:33:28 +01:00
prettier.config.js ci: enable renovate automerge, pin actions (#2012) 2024-07-23 11:13:39 +10:00
README.md docs: use the dynamic README header endpoint (#7940) 2026-08-03 21:03:29 +02:00
top-10-how-to-guides.md docs: Identify top 10 how-to docs, add deployment guide (#4701) 2025-07-18 15:15:07 -06:00
tsconfig.json optimize streaming (#8204) 2026-09-16 22:38:25 +02:00

TanStack Router

TanStack Router

A modern router designed for type safety, data‑driven navigation, and seamless developer experience.

  • End‑to-end type safety (routes, params, loaders)
  • Schema‑driven search params with validation
  • Built‑in caching, prefetching & invalidation
  • Nested layouts, transitions & error boundaries

Read the Router Docs →

TanStack Start

TanStack Start

A full‑stack framework built on Router, designed for server rendering, streaming, and production‑ready deployments.

  • Full‑document SSR & streaming
  • Server functions & end‑to‑end type safety
  • Deployment‑ready bundling & builds
  • All the power of TanStack Router, plus full‑stack features

Read the Start Docs →


npm downloads GitHub stars Bundle size

semantic-release Best of JS Follow @TanStack

Get Involved

Partners

CodeRabbit Cloudflare Netlify
Neon Clerk Convex
Sentry Prisma Strapi
Router & you?

We're looking for TanStack Router & Start Partners to join our mission! Partner with us to push the boundaries of TanStack Router & Start and build amazing things together.

LET'S CHAT

Explore the TanStack Ecosystem

… and more at TanStack.com »