Open History to see the last commit
1# skills/_artifacts/skill_tree.yaml
2library:
3 name: '@tanstack/router'
4 version: '1.166.2'
5 repository: 'https://github.com/TanStack/router'
6 description: >-
7 Type-safe router for React and Solid with built-in SWR caching,
8 JSON-first search params, and end-to-end type inference.
9generated_from:
10 domain_map: '_artifacts/domain_map.yaml'
11 skill_spec: '_artifacts/skill_spec.md'
12generated_at: '2026-03-07'
13β
14skills:
15 # ββ Router Core Skills βββββββββββββββββββββββββββββββββββββββββββ
16 - name: 'Router Core'
17 slug: 'router-core'
18 type: 'core'
19 domain: 'defining-routes'
20 path: 'skills/router-core/SKILL.md'
21 package: 'packages/router-core'
22 description: >-
23 Framework-agnostic core concepts for TanStack Router: route trees,
24 createRouter, createRoute, createRootRoute, createRootRouteWithContext,
25 addChildren, Register type declaration, route matching, route sorting,
26 file naming conventions. Entry point for all router skills.
27 sources:
28 - 'TanStack/router:docs/router/overview.md'
29 - 'TanStack/router:docs/router/routing/routing-concepts.md'
30 - 'TanStack/router:docs/router/routing/route-trees.md'
31 - 'TanStack/router:docs/router/routing/route-matching.md'
32 - 'TanStack/router:docs/router/guide/creating-a-router.md'
33 - 'TanStack/router:docs/router/decisions-on-dx.md'
34 - 'TanStack/router:packages/router-core/src'
35β
36 - name: 'Search Params'
37 slug: 'router-core/search-params'
38 type: 'sub-skill'
39 domain: 'managing-url-state'
40 path: 'skills/router-core/search-params/SKILL.md'
41 package: 'packages/router-core'
42 description: >-
43 validateSearch, search param validation with Zod/Valibot/ArkType adapters,
44 fallback(), search middlewares (retainSearchParams, stripSearchParams),
45 custom serialization (parseSearch, stringifySearch), search param
46 inheritance, loaderDeps for cache keys, reading and writing search params.
47 requires:
48 - 'router-core'
49 sources:
50 - 'TanStack/router:docs/router/guide/search-params.md'
51 - 'TanStack/router:docs/router/how-to/setup-basic-search-params.md'
52 - 'TanStack/router:docs/router/how-to/validate-search-params.md'
53 - 'TanStack/router:docs/router/how-to/navigate-with-search-params.md'
54 - 'TanStack/router:docs/router/how-to/share-search-params-across-routes.md'
55 - 'TanStack/router:docs/router/how-to/arrays-objects-dates-search-params.md'
56 - 'TanStack/router:docs/router/guide/custom-search-param-serialization.md'
57 subsystems:
58 - 'Zod adapter'
59 - 'Valibot adapter'
60 - 'ArkType adapter'
61 references:
62 - 'references/validation-patterns.md'
63β
64 - name: 'Path Params'
65 slug: 'router-core/path-params'
66 type: 'sub-skill'
67 domain: 'managing-url-state'
68 path: 'skills/router-core/path-params/SKILL.md'
69 package: 'packages/router-core'
70 description: >-
71 Dynamic path segments ($paramName), splat routes ($ / _splat),
72 optional params ({-$paramName}), prefix/suffix patterns ({$param}.ext),
73 useParams, params.parse/stringify, pathParamsAllowedCharacters,
74 i18n locale patterns.
75 requires:
76 - 'router-core'
77 sources:
78 - 'TanStack/router:docs/router/guide/path-params.md'
79 - 'TanStack/router:docs/router/guide/internationalization-i18n.md'
80 - 'TanStack/router:docs/router/routing/routing-concepts.md'
81β
82 - name: 'Navigation'
83 slug: 'router-core/navigation'
84 type: 'sub-skill'
85 domain: 'navigating'
86 path: 'skills/router-core/navigation/SKILL.md'
87 package: 'packages/router-core'
88 description: >-
89 Link component, useNavigate, Navigate component, router.navigate,
90 ToOptions/NavigateOptions/LinkOptions, from/to relative navigation,
91 activeOptions/activeProps, preloading (intent/viewport/render),
92 preloadDelay, navigation blocking (useBlocker, Block), createLink,
93 linkOptions helper, scroll restoration, MatchRoute.
94 requires:
95 - 'router-core'
96 sources:
97 - 'TanStack/router:docs/router/guide/navigation.md'
98 - 'TanStack/router:docs/router/guide/preloading.md'
99 - 'TanStack/router:docs/router/guide/navigation-blocking.md'
100 - 'TanStack/router:docs/router/guide/link-options.md'
101 - 'TanStack/router:docs/router/guide/custom-link.md'
102 - 'TanStack/router:docs/router/guide/scroll-restoration.md'
103β
104 - name: 'Data Loading'
105 slug: 'router-core/data-loading'
106 type: 'sub-skill'
107 domain: 'loading-data'
108 path: 'skills/router-core/data-loading/SKILL.md'
109 package: 'packages/router-core'
110 description: >-
111 Route loader option, loaderDeps for cache keys, staleTime/gcTime/
112 defaultPreloadStaleTime SWR caching, pendingComponent/pendingMs/
113 pendingMinMs, errorComponent/onError/onCatch, beforeLoad, router
114 context and createRootRouteWithContext DI pattern, router.invalidate,
115 Await component, deferred data loading with unawaited promises.
116 requires:
117 - 'router-core'
118 sources:
119 - 'TanStack/router:docs/router/guide/data-loading.md'
120 - 'TanStack/router:docs/router/guide/deferred-data-loading.md'
121 - 'TanStack/router:docs/router/guide/router-context.md'
122 - 'TanStack/router:docs/router/guide/data-mutations.md'
123β
124 - name: 'Auth and Guards'
125 slug: 'router-core/auth-and-guards'
126 type: 'sub-skill'
127 domain: 'protecting-routes'
128 path: 'skills/router-core/auth-and-guards/SKILL.md'
129 package: 'packages/router-core'
130 description: >-
131 Route protection with beforeLoad, redirect()/throw redirect(),
132 isRedirect helper, authenticated layout routes (_authenticated),
133 non-redirect auth (inline login), RBAC with roles and permissions,
134 auth provider integration (Auth0, Clerk, Supabase), router context
135 for auth state.
136 requires:
137 - 'router-core'
138 sources:
139 - 'TanStack/router:docs/router/guide/authenticated-routes.md'
140 - 'TanStack/router:docs/router/how-to/setup-authentication.md'
141 - 'TanStack/router:docs/router/how-to/setup-auth-providers.md'
142 - 'TanStack/router:docs/router/how-to/setup-rbac.md'
143β
144 - name: 'Code Splitting'
145 slug: 'router-core/code-splitting'
146 type: 'sub-skill'
147 domain: 'rendering-and-layout'
148 path: 'skills/router-core/code-splitting/SKILL.md'
149 package: 'packages/router-core'
150 description: >-
151 Automatic code splitting (autoCodeSplitting), .lazy.tsx convention,
152 createLazyFileRoute, createLazyRoute, lazyRouteComponent, getRouteApi
153 for typed hooks in split files, codeSplitGroupings per-route override,
154 splitBehavior programmatic config, critical vs non-critical properties.
155 requires:
156 - 'router-core'
157 sources:
158 - 'TanStack/router:docs/router/guide/code-splitting.md'
159 - 'TanStack/router:docs/router/guide/automatic-code-splitting.md'
160β
161 - name: 'Not Found and Errors'
162 slug: 'router-core/not-found-and-errors'
163 type: 'sub-skill'
164 domain: 'rendering-and-layout'
165 path: 'skills/router-core/not-found-and-errors/SKILL.md'
166 package: 'packages/router-core'
167 description: >-
168 notFound() function, notFoundComponent, defaultNotFoundComponent,
169 notFoundMode (fuzzy/root), errorComponent, onError/onCatch,
170 CatchBoundary, NotFoundRoute (deprecated), route masking (mask
171 option, createRouteMask, unmaskOnReload).
172 requires:
173 - 'router-core'
174 sources:
175 - 'TanStack/router:docs/router/guide/not-found-errors.md'
176 - 'TanStack/router:docs/router/guide/route-masking.md'
177β
178 - name: 'Type Safety'
179 slug: 'router-core/type-safety'
180 type: 'sub-skill'
181 domain: 'type-safety'
182 path: 'skills/router-core/type-safety/SKILL.md'
183 package: 'packages/router-core'
184 description: >-
185 Full type inference philosophy (never cast, never annotate inferred
186 values), Register module declaration, from narrowing on hooks and
187 Link, strict:false for shared components, getRouteApi for code-split
188 typed access, addChildren with object syntax for TS perf, LinkProps
189 and ValidateLinkOptions type utilities, as const satisfies pattern.
190 requires:
191 - 'router-core'
192 sources:
193 - 'TanStack/router:docs/router/guide/type-safety.md'
194 - 'TanStack/router:docs/router/guide/type-utilities.md'
195 - 'TanStack/router:docs/router/guide/render-optimizations.md'
196β
197 - name: 'SSR'
198 slug: 'router-core/ssr'
199 type: 'sub-skill'
200 domain: 'server-side-rendering'
201 path: 'skills/router-core/ssr/SKILL.md'
202 package: 'packages/router-core'
203 description: >-
204 Non-streaming and streaming SSR, RouterClient/RouterServer,
205 renderRouterToString/renderRouterToStream, createRequestHandler,
206 defaultRenderHandler/defaultStreamHandler, HeadContent/Scripts
207 components, head route option (meta/links/styles/scripts),
208 ScriptOnce, automatic loader dehydration/hydration, memory
209 history on server, data serialization, document head management.
210 requires:
211 - 'router-core'
212 - 'router-core/data-loading'
213 sources:
214 - 'TanStack/router:docs/router/guide/ssr.md'
215 - 'TanStack/router:docs/router/guide/document-head-management.md'
216 - 'TanStack/router:docs/router/how-to/setup-ssr.md'
217β
218 # ββ React Router Skills ββββββββββββββββββββββββββββββββββββββββββ
219 - name: 'React Router'
220 slug: 'react-router'
221 type: 'framework'
222 domain: 'defining-routes'
223 path: 'skills/react-router/SKILL.md'
224 package: 'packages/react-router'
225 description: >-
226 React bindings for TanStack Router: RouterProvider, useRouter,
227 useRouterState, useMatch, useMatches, useLocation, useSearch,
228 useParams, useNavigate, useLoaderData, useLoaderDeps,
229 useRouteContext, useBlocker, useCanGoBack, Link, Navigate,
230 Outlet, CatchBoundary, ErrorComponent. React-specific patterns
231 for hooks, providers, SSR hydration, and createLink with
232 forwardRef.
233 requires:
234 - 'router-core'
235 sources:
236 - 'TanStack/router:packages/react-router/src'
237 - 'TanStack/router:docs/router/guide/creating-a-router.md'
238 - 'TanStack/router:docs/router/installation/manual.md'
239β
240 # ββ Composition Skills βββββββββββββββββββββββββββββββββββββββββββ
241 - name: 'External Data Loading (TanStack Query)'
242 slug: 'compositions/router-query'
243 type: 'composition'
244 domain: 'loading-data'
245 path: 'skills/compositions/router-query/SKILL.md'
246 package: 'packages/react-router'
247 description: >-
248 Integrating TanStack Router with TanStack Query: queryClient
249 in router context, ensureQueryData/prefetchQuery in loaders,
250 useSuspenseQuery in components, defaultPreloadStaleTime: 0,
251 setupRouterSsrQueryIntegration for SSR dehydration/hydration
252 and streaming, per-request QueryClient isolation.
253 requires:
254 - 'router-core'
255 - 'router-core/data-loading'
256 - 'react-router'
257 sources:
258 - 'TanStack/router:docs/router/guide/external-data-loading.md'
259 - 'TanStack/router:docs/router/integrations/query.md'
260β
261 # ββ Lifecycle Skills βββββββββββββββββββββββββββββββββββββββββββββ
262 - name: 'Migrate from React Router'
263 slug: 'lifecycle/migrate-from-react-router'
264 type: 'lifecycle'
265 domain: 'defining-routes'
266 path: 'skills/lifecycle/migrate-from-react-router/SKILL.md'
267 package: 'packages/react-router'
268 description: >-
269 Step-by-step migration from React Router v7 to TanStack Router:
270 route definition conversion, Link/useNavigate API differences,
271 useSearchParams to validateSearch + useSearch, useParams with from,
272 Outlet replacement, loader conversion, code splitting differences.
273 requires:
274 - 'router-core'
275 - 'react-router'
276 sources:
277 - 'TanStack/router:docs/router/how-to/migrate-from-react-router.md'
278 - 'TanStack/router:docs/router/installation/migrate-from-react-router.md'