AGENT SKILL

tanstack-router

TanStack Router (v1+) reference for code-based routing, loaders, search params, navigation, link composition, route guards, and integration patterns. Use when working with files under src/ that import from '@tanstack/react-router', when creating or modifying routes/route trees, when designing data-loading via route loaders or beforeLoad, when adding type-safe Links/useNavigate/useParams/useSearch, when configuring RouterProvider or createRouter, or whenever the user mentions "tanstack router", "route loader", "useParams", "useNavigate", "search params", "beforeLoad", or "code-based routes". Also triggers for migration questions from react-router or other routers.

License 许可
Apache-2.0
最近更新
2026-11-02
Stars
★ 3
Forks
3

01 前言 Front Matter

name
tanstack-router
description
TanStack Router (v1+) reference for code-based routing, loaders, search params, navigation, link composition, route guards, and integration patterns. Use when working with files under src/ that import from '@tanstack/react-router', when creating or modifying routes/route trees, when designing data-loading via route loaders or beforeLoad, when adding type-safe Links/useNavigate/useParams/useSearch, when configuring RouterProvider or createRouter, or whenever the user mentions "tanstack router", "route loader", "useParams", "useNavigate", "search params", "beforeLoad", or "code-based routes". Also triggers for migration questions from react-router or other routers.
user-invocable
false

02 资源文件 5

03 SKILL.md 正文

TanStack Router

Reference docs split into focused sections. Read the section matching the task:

File When to use
api.md API surface: every export, type, hook, component. Use when you need exact signatures (useNavigate, useRouterState, Link, redirect, createRoute, etc.).
routing.md Route tree composition: createRootRoute, createRoute, addChildren, path params ($person), splats, layout routes, route options.
guide.md Deep-dive patterns: authenticated routes, search params, data loading via loaders, code splitting, custom search-param serialization, navigation, redirect semantics.
installation.md Setup: install command, RouterProvider mount, TypeScript Register augmentation.
setup-and-architecture.md Architecture rationale, type-safety model, loader-vs-on-mount tradeoffs, comparison with other routers.

Quick reference (most common patterns)

Code-based route definition

import { createRootRoute, createRoute, createRouter, Outlet } from '@tanstack/react-router';

const rootRoute = createRootRoute({
  component: () => <Outlet />,
});

const personRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/ic-dashboard/$person',
  loader: ({ params }) => fetchPerson(params.person),  // runs BEFORE render
  component: PersonScreen,
});

const routeTree = rootRoute.addChildren([personRoute]);
export const router = createRouter({ routeTree });

declare module '@tanstack/react-router' {
  interface Register { router: typeof router }
}

Reading route params + loader data inside a component

function PersonScreen() {
  const { person } = personRoute.useParams();
  const data = personRoute.useLoaderData();
  // ...
}

Type-safe navigation

const navigate = useNavigate();
navigate({ to: '/ic-dashboard/$person', params: { person: email } });

Type-safe Link

<Link to="/ic-dashboard/$person" params={{ person: email }}>{name}</Link>

Redirect from loader / beforeLoad

beforeLoad: ({ context, location }) => {
  if (!context.user) {
    throw redirect({ to: '/login', search: { redirect: location.href } });
  }
}

Search params (typed, validated)

const route = createRoute({
  // ...
  validateSearch: (search: Record<string, unknown>) => ({
    page: Number(search.page ?? 1),
    sort: (search.sort as 'asc' | 'desc') ?? 'asc',
  }),
});
// In component:
const { page, sort } = route.useSearch();

Loader-first data loading

Prefer route loader over on-mount React Query for primary screen data:

  • Runs in parallel with code-split route component download → no waterfall
  • Data available on first render, no isPending flash
  • Pairs with React Query via queryClient.ensureQueryData(...) inside the loader
loader: ({ params, context: { queryClient } }) =>
  queryClient.ensureQueryData(personQuery(params.person)),

Then the component reads the same query via useSuspenseQuery(personQuery(person)) — cache hit guaranteed.

See guide.md "Data Loading" section for full pattern.

04 同仓库更多 Skills

constructorfabric
constructorfabric/insight-front

cypilot-sdlc

Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status

★ 3
constructorfabric
constructorfabric/insight-front

config

暂无简介

★ 3
constructorfabric
constructorfabric/insight-front

.gen

暂无简介

★ 3
constructorfabric
constructorfabric/insight-front

cypilot

Invoke when user asks to do something with Cypilot, or wants to analyze/validate artifacts, or create/generate/implement anything using Cypilot workflows, or plan phased execution. Core capabilities: workflow routing (plan/analyze/generate/auto-config); deterministic validation (structure, cross-refs, traceability, TOC); code↔artifact traceability with @cpt-* markers; spec coverage measurement; ID search/navigation; init/bootstrap; adapter + registry discovery; auto-configuration of brownfield projects (scan conventions, generate rules); kit management (install/update with file-level diff); TOC generation; agent integrations (Windsurf, Cursor, Claude, Copilot, OpenAI).

★ 3
constructorfabric
constructorfabric/insight-front

cypilot

Invoke when user asks to do something with Cypilot, or wants to analyze/validate artifacts, or create/generate/implement anything using Cypilot workflows, or plan phased execution. Core capabilities: workflow routing (plan/analyze/generate/auto-config); deterministic validation (structure, cross-refs, traceability, TOC); code↔artifact traceability with @cpt-* markers; spec coverage measurement; ID search/navigation; init/bootstrap; adapter + registry discovery; auto-configuration of brownfield projects (scan conventions, generate rules); kit management (install/update with file-level diff); TOC generation; agent integrations (Windsurf, Cursor, Claude, Copilot, OpenAI). Kit sdlc: Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status.

★ 3
constructorfabric
constructorfabric/insight-front

cypilot-workspace

Multi-repo workspace setup — discover repos, configure sources, generate workspace config, validate

★ 3