{"slug":"skilld-dev-tanstack-vue-router-skilld","name":"tanstack-vue-router-skilld","description":"Modern and scalable routing for Vue applications. ALWAYS use when writing code importing \\\"@tanstack/vue-router\\\". Consult for debugging, best practices, or modifying @tanstack/vue-router, tanstack/vue-router, tanstack vue-router, tanstack vue router, router.","long_description":"---\nname: tanstack-vue-router-skilld\ndescription: \"Modern and scalable routing for Vue applications. ALWAYS use when writing code importing \\\"@tanstack/vue-router\\\". Consult for debugging, best practices, or modifying @tanstack/vue-router, tanstack/vue-router, tanstack vue-router, tanstack vue router, router.\"\nmetadata:\n version: 1.166.7\n generated_at: 2026-03-11\n references_synced_at: 2026-05-05\n---\n\n# TanStack/router `@tanstack/vue-router`\n\n> Modern and scalable routing for Vue applications\n\n**Version:** 1.166.7 (Mar 2026)\n**Deps:** @tanstack/vue-store@^0.9.1, @vue/runtime-dom@^3.5.25, isbot@^5.1.22, jsesc@^3.0.2, tiny-invariant@^1.3.3, tiny-warning@^1.0.3, @tanstack/history@1.161.4, @tanstack/router-core@1.166.7\n**Tags:** latest: 1.166.7 (Mar 2026)\n\n**References:** [Docs](./references/docs/_INDEX.md) — API reference, guides\n## API Changes\n\nThis section documents version-specific API changes — prioritize recent major/minor releases.\n\n- BREAKING: `NotFoundRoute` & `routerOptions.notFoundRoute` — deprecated in v1.x; use `notFoundComponent` in route options or `defaultNotFoundComponent` in `createRouter` instead [source](./references/docs/router/guide/not-found-errors.md:L5)\n\n- DEPRECATED: Router Classes (`Router`, `Route`, `RootRoute`, `FileRoute`) — all class-based APIs are deprecated; use factory functions `createRouter`, `createRoute`, `createRootRoute`, and `createFileRoute` instead [source](./references/docs/router/api/router/RouterClass.md:L7)\n\n- DEPRECATED: `opts.navigate` — the `navigate` argument inside `beforeLoad` and `loader` is deprecated; use `throw redirect({ to: '...' })` for navigation-triggered redirects instead [source](./references/docs/router/api/router/RouteOptionsType.md:L118)\n\n- DEPRECATED: `parseParams` & `stringifyParams` — top-level route properties deprecated in favor of the nested `params.parse` and `params.stringify` objects [source](./references/docs/router/api/router/RouteOptionsType.md:L68)\n\n- DEPRECATED: `preSearchFilters` & `postSearchFilters` — deprecated in favor of `search.middlewares` array which provides a composable middleware pipeline for transforming search params [source](./references/docs/router/api/router/RouteOptionsType.md:L225)\n\n- DEPRECATED: `` component — deprecated; configure scroll restoration via `scrollRestoration: true` in `createRouter` options instead [source](./references/docs/router/guide/scroll-restoration.md:L64)\n\n- NEW: `protocolAllowlist` — `createRouter` option accepting `Array` of allowed URL protocols (e.g. `'https:'`, `'mailto:'`); absolute URLs with unlisted protocols are blocked to prevent XSS; also exports `DEFAULT_PROTOCOL_ALLOWLIST` constant [source](./references/docs/router/api/router/RouterOptionsType.md:L147)\n\n- NEW: `search.middlewares` — route option accepting an array of middleware functions `({search, next}) => search` for composable search param transformation when generating links; use with `retainSearchParams` and `stripSearchParams` helpers [source](./references/docs/router/api/router/RouteOptionsType.md:L61)\n\n- NEW: `head`, `headers`, `scripts` — route option methods for server-side document management; `head()` injects ``, ``, `