@tanstack/react-router 1.159.14 → 1.160.2

package/dist/llms/rules/installation.js

@@ -6,21 +6,23 @@ To set up TanStack Router manually in a React project, follow the steps below. T
 
 #### Install TanStack Router, Vite Plugin, and the Router Devtools
 
-\`\`\`sh
-npm install @tanstack/react-router @tanstack/react-router-devtools
-npm install -D @tanstack/router-plugin
-# or
-pnpm add @tanstack/react-router @tanstack/react-router-devtools
-pnpm add -D @tanstack/router-plugin
-# or
-yarn add @tanstack/react-router @tanstack/react-router-devtools
-yarn add -D @tanstack/router-plugin
-# or
-bun add @tanstack/react-router @tanstack/react-router-devtools
-bun add -D @tanstack/router-plugin
-# or
-deno add npm:@tanstack/react-router npm:@tanstack/router-plugin npm:@tanstack/react-router-devtools
-\`\`\`
+Install the necessary core dependencies:
+
+<!-- ::start:tabs variant="package-managers" -->
+
+react: @tanstack/react-router @tanstack/react-router-devtools
+solid: @tanstack/solid-router @tanstack/solid-router-devtools
+
+<!-- ::end:tabs -->
+
+Install the necessary development dependencies:
+
+<!-- ::start:tabs variant="package-managers" mode="dev-install" -->
+
+react: @tanstack/router-plugin
+solid: @tanstack/router-plugin
+
+<!-- ::end:tabs -->
 
 #### Configure the Vite Plugin
 
@@ -54,9 +56,13 @@ Create the following files:
 - \`src/routes/about.tsx\`
 - \`src/main.tsx\`
 
-#### \`src/routes/__root.tsx\`
+<!-- ::start:framework -->
 
-\`\`\`tsx
+# React
+
+<!-- ::start:tabs variant="files" -->
+
+\`\`\`tsx title="src/routes/__root.tsx"
 import { createRootRoute, Link, Outlet } from '@tanstack/react-router'
 import { TanStackRouterDevtools } from '@tanstack/react-router-devtools'
 
@@ -79,9 +85,7 @@ const RootLayout = () => (
 export const Route = createRootRoute({ component: RootLayout })
 \`\`\`
 
-#### \`src/routes/index.tsx\`
-
-\`\`\`tsx
+\`\`\`tsx title="src/routes/index.tsx"
 import { createFileRoute } from '@tanstack/react-router'
 
 export const Route = createFileRoute('/')({
@@ -97,9 +101,7 @@ function Index() {
 }
 \`\`\`
 
-#### \`src/routes/about.tsx\`
-
-\`\`\`tsx
+\`\`\`tsx title="src/routes/about.tsx"
 import { createFileRoute } from '@tanstack/react-router'
 
 export const Route = createFileRoute('/about')({
@@ -111,13 +113,7 @@ function About() {
 }
 \`\`\`
 
-#### \`src/main.tsx\`
-
-Regardless of whether you are using the \`@tanstack/router-plugin\` package and running the \`npm run dev\`/\`npm run build\` scripts, or manually running the \`tsr watch\`/\`tsr generate\` commands from your package scripts, the route tree file will be generated at \`src/routeTree.gen.ts\`.
-
-Import the generated route tree and create a new router instance:
-
-\`\`\`tsx
+\`\`\`tsx title="src/main.tsx"
 import { StrictMode } from 'react'
 import ReactDOM from 'react-dom/client'
 import { RouterProvider, createRouter } from '@tanstack/react-router'
@@ -147,6 +143,93 @@ if (!rootElement.innerHTML) {
 }
 \`\`\`
 
+<!-- ::end:tabs -->
+
+# Solid
+
+<!-- ::start:tabs variant="files" -->
+
+\`\`\`tsx title="src/routes/__root.tsx"
+import { createRootRoute, Link, Outlet } from '@tanstack/solid-router'
+import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools'
+
+const RootLayout = () => (
+  <>
+    <div class="p-2 flex gap-2">
+      <Link to="/" class="[&.active]:font-bold">
+        Home
+      </Link>{' '}
+      <Link to="/about" class="[&.active]:font-bold">
+        About
+      </Link>
+    </div>
+    <hr />
+    <Outlet />
+    <TanStackRouterDevtools />
+  </>
+)
+
+export const Route = createRootRoute({ component: RootLayout })
+\`\`\`
+
+\`\`\`tsx title="src/routes/index.tsx"
+import { createFileRoute } from '@tanstack/solid-router'
+
+export const Route = createFileRoute('/')({
+  component: Index,
+})
+
+function Index() {
+  return (
+    <div class="p-2">
+      <h3>Welcome Home!</h3>
+    </div>
+  )
+}
+\`\`\`
+
+\`\`\`tsx title="src/routes/about.tsx"
+import { createFileRoute } from '@tanstack/solid-router'
+
+export const Route = createFileRoute('/about')({
+  component: About,
+})
+
+function About() {
+  return <div class="p-2">Hello from About!</div>
+}
+\`\`\`
+
+\`\`\`tsx title="src/main.tsx"
+/* @refresh reload */
+import { render } from 'solid-js/web'
+import { RouterProvider, createRouter } from '@tanstack/solid-router'
+
+// Import the generated route tree
+import { routeTree } from './routeTree.gen'
+
+// Create a new router instance
+const router = createRouter({ routeTree })
+
+// Register the router instance for type safety
+declare module '@tanstack/solid-router' {
+  interface Register {
+    router: typeof router
+  }
+}
+
+// Render the app
+const rootElement = document.getElementById('root')!
+
+render(() => <RouterProvider router={router} />, rootElement)
+\`\`\`
+
+<!-- ::end:tabs -->
+
+<!-- ::end:framework -->
+
+Regardless of whether you are using the \`@tanstack/router-plugin\` package and running the \`npm run dev\`/\`npm run build\` scripts, or manually running the \`tsr watch\`/\`tsr generate\` commands from your package scripts, the route tree file will be generated at \`src/routeTree.gen.ts\`.
+
 If you are working with this pattern you should change the \`id\` of the root \`<div>\` on your \`index.html\` file to \`<div id='root'></div>\`
 
 ## Using Code-Based Route Configuration
@@ -154,6 +237,10 @@ If you are working with this pattern you should change the \`id\` of the root \`
 > [!IMPORTANT]
 > The following example shows how to configure routes using code, and for simplicity's sake is in a single file for this demo. While code-based generation allows you to declare many routes and even the router instance in a single file, we recommend splitting your routes into separate files for better organization and performance as your application grows.
 
+<!-- ::start:framework -->
+
+# React
+
 \`\`\`tsx
 import { StrictMode } from 'react'
 import ReactDOM from 'react-dom/client'
@@ -226,320 +313,95 @@ if (!rootElement.innerHTML) {
 }
 \`\`\`
 
-If you glossed over these examples or didn't understand something, we don't blame you, because there's so much more to learn to really take advantage of TanStack Router! Let's move on.
-
-# Migration from React Location
-
-Before you begin your journey in migrating from React Location, it's important that you have a good understanding of the [Routing Concepts](../routing/routing-concepts.md) and [Design Decisions](../decisions-on-dx.md) used by TanStack Router.
-
-## Differences between React Location and TanStack Router
-
-React Location and TanStack Router share much of same design decisions concepts, but there are some key differences that you should be aware of.
-
-- React Location uses _generics_ to infer types for routes, while TanStack Router uses _module declaration merging_ to infer types.
-- Route configuration in React Location is done using a single array of route definitions, while in TanStack Router, route configuration is done using a tree of route definitions starting with the [root route](../routing/routing-concepts.md#the-root-route).
-- [File-based routing](../routing/file-based-routing.md) is the recommended way to define routes in TanStack Router, while React Location only allows you to define routes in a single file using a code-based approach.
-  - TanStack Router does support a [code-based approach](../routing/code-based-routing.md) to defining routes, but it is not recommended for most use cases. You can read more about why, over here: [why is file-based routing the preferred way to define routes?](../decisions-on-dx.md#why-is-file-based-routing-the-preferred-way-to-define-routes)
-
-## Migration guide
-
-In this guide we'll go over the process of migrating the [React Location Basic example](https://github.com/TanStack/router/tree/react-location/examples/basic) over to TanStack Router using file-based routing, with the end goal of having the same functionality as the original example (styling and other non-routing related code will be omitted).
-
-> [!TIP]
-> To use a code-based approach for defining your routes, you can read the [code-based Routing](../routing/code-based-routing.md) guide.
-
-### Step 1: Swap over to TanStack Router's dependencies
-
-First, we need to install the dependencies for TanStack Router. For detailed installation instructions, see our [How to Install TanStack Router](../how-to/install.md) guide.
-
-\`\`\`sh
-npm install @tanstack/react-router @tanstack/router-devtools
-\`\`\`
-
-And remove the React Location dependencies.
+# Solid
 
-\`\`\`sh
-npm uninstall @tanstack/react-location @tanstack/react-location-devtools
-\`\`\`
-
-### Step 2: Use the file-based routing watcher
-
-If your project uses Vite (or one of the supported bundlers), you can use the TanStack Router plugin to watch for changes in your routes files and automatically update the routes configuration.
-
-Installation of the Vite plugin:
-
-\`\`\`sh
-npm install -D @tanstack/router-plugin
-\`\`\`
-
-And add it to your \`vite.config.js\`:
-
-\`\`\`js
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import { tanstackRouter } from '@tanstack/router-plugin/vite'
+\`\`\`tsx
+/* @refresh reload */
+import { render } from 'solid-js/web'
+import {
+  Outlet,
+  RouterProvider,
+  Link,
+  createRouter,
+  createRoute,
+  createRootRoute,
+} from '@tanstack/solid-router'
+import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools'
 
-export default defineConfig({
-  // ...
-  plugins: [tanstackRouter(), react()],
+const rootRoute = createRootRoute({
+  component: () => (
+    <>
+      <div class="p-2 flex gap-2">
+        <Link to="/" class="[&.active]:font-bold">
+          Home
+        </Link>{' '}
+        <Link to="/about" class="[&.active]:font-bold">
+          About
+        </Link>
+      </div>
+      <hr />
+      <Outlet />
+      <TanStackRouterDevtools />
+    </>
+  ),
 })
-\`\`\`
-
-However, if your application does not use Vite, you use one of our other [supported bundlers](../routing/file-based-routing.md#getting-started-with-file-based-routing), or you can use the \`@tanstack/router-cli\` package to watch for changes in your routes files and automatically update the routes configuration.
-
-### Step 3: Add the file-based configuration file to your project
-
-Create a \`tsr.config.json\` file in the root of your project with the following content:
-
-\`\`\`json
-{
-  "routesDirectory": "./src/routes",
-  "generatedRouteTree": "./src/routeTree.gen.ts"
-}
-\`\`\`
-
-You can find the full list of options for the \`tsr.config.json\` file [here](../routing/file-based-routing.md).
 
-### Step 4: Create the routes directory
-
-Create a \`routes\` directory in the \`src\` directory of your project.
-
-\`\`\`sh
-mkdir src/routes
-\`\`\`
-
-### Step 5: Create the root route file
-
-\`\`\`tsx
-// src/routes/__root.tsx
-import { createRootRoute, Outlet, Link } from '@tanstack/react-router'
-import { TanStackRouterDevtools } from '@tanstack/router-devtools'
-
-export const Route = createRootRoute({
-  component: () => {
+const indexRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: '/',
+  component: function Index() {
     return (
-      <>
-        <div>
-          <Link to="/" activeOptions={{ exact: true }}>
-            Home
-          </Link>
-          <Link to="/posts">Posts</Link>
-        </div>
-        <hr />
-        <Outlet />
-        <TanStackRouterDevtools />
-      </>
+      <div class="p-2">
+        <h3>Welcome Home!</h3>
+      </div>
     )
   },
 })
-\`\`\`
-
-### Step 6: Create the index route file
-
-\`\`\`tsx
-// src/routes/index.tsx
-import { createFileRoute } from '@tanstack/react-router'
 
-export const Route = createFileRoute('/')({
-  component: Index,
-})
-\`\`\`
-
-> You will need to move any related components and logic needed for the index route from the \`src/index.tsx\` file to the \`src/routes/index.tsx\` file.
-
-### Step 7: Create the posts route file
-
-\`\`\`tsx
-// src/routes/posts.tsx
-import { createFileRoute, Link, Outlet } from '@tanstack/react-router'
-
-export const Route = createFileRoute('/posts')({
-  component: Posts,
-  loader: async () => {
-    const posts = await fetchPosts()
-    return {
-      posts,
-    }
-  },
-})
-
-function Posts() {
-  const { posts } = Route.useLoaderData()
-  return (
-    <div>
-      <nav>
-        {posts.map((post) => (
-          <Link
-            key={post.id}
-            to={\`/posts/$postId\`}
-            params={{ postId: post.id }}
-          >
-            {post.title}
-          </Link>
-        ))}
-      </nav>
-      <Outlet />
-    </div>
-  )
-}
-\`\`\`
-
-> You will need to move any related components and logic needed for the posts route from the \`src/index.tsx\` file to the \`src/routes/posts.tsx\` file.
-
-### Step 8: Create the posts index route file
-
-\`\`\`tsx
-// src/routes/posts.index.tsx
-import { createFileRoute } from '@tanstack/react-router'
-
-export const Route = createFileRoute('/posts/')({
-  component: PostsIndex,
-})
-\`\`\`
-
-> You will need to move any related components and logic needed for the posts index route from the \`src/index.tsx\` file to the \`src/routes/posts.index.tsx\` file.
-
-### Step 9: Create the posts id route file
-
-\`\`\`tsx
-// src/routes/posts.$postId.tsx
-import { createFileRoute } from '@tanstack/react-router'
-
-export const Route = createFileRoute('/posts/$postId')({
-  component: PostsId,
-  loader: async ({ params: { postId } }) => {
-    const post = await fetchPost(postId)
-    return {
-      post,
-    }
+const aboutRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: '/about',
+  component: function About() {
+    return <div class="p-2">Hello from About!</div>
   },
 })
 
-function PostsId() {
-  const { post } = Route.useLoaderData()
-  // ...
-}
-\`\`\`
-
-> You will need to move any related components and logic needed for the posts id route from the \`src/index.tsx\` file to the \`src/routes/posts.$postId.tsx\` file.
-
-### Step 10: Generate the route tree
-
-If you are using one of the supported bundlers, the route tree will be generated automatically when you run the dev script.
-
-If you are not using one of the supported bundlers, you can generate the route tree by running the following command:
-
-\`\`\`sh
-npx tsr generate
-\`\`\`
-
-### Step 11: Update the main entry file to render the Router
-
-Once you've generated the route-tree, you can then update the \`src/index.tsx\` file to create the router instance and render it.
-
-\`\`\`tsx
-// src/index.tsx
-import React from 'react'
-import ReactDOM from 'react-dom'
-import { createRouter, RouterProvider } from '@tanstack/react-router'
-
-// Import the generated route tree
-import { routeTree } from './routeTree.gen'
+const routeTree = rootRoute.addChildren([indexRoute, aboutRoute])
 
-// Create a new router instance
 const router = createRouter({ routeTree })
 
-// Register the router instance for type safety
-declare module '@tanstack/react-router' {
+declare module '@tanstack/solid-router' {
   interface Register {
     router: typeof router
   }
 }
 
-const domElementId = 'root' // Assuming you have a root element with the id 'root'
-
-// Render the app
-const rootElement = document.getElementById(domElementId)
-if (!rootElement) {
-  throw new Error(\`Element with id \${domElementId} not found\`)
-}
-
-ReactDOM.createRoot(rootElement).render(
-  <React.StrictMode>
-    <RouterProvider router={router} />
-  </React.StrictMode>,
-)
+const rootElement = document.getElementById('app')!
+render(() => <RouterProvider router={router} />, rootElement)
 \`\`\`
 
-### Finished!
-
-You should now have successfully migrated your application from React Location to TanStack Router using file-based routing.
-
-React Location also has a few more features that you might be using in your application. Here are some guides to help you migrate those features:
-
-- [Search params](../guide/search-params.md)
-- [Data loading](../guide/data-loading.md)
-- [History types](../guide/history-types.md)
-- [Wildcard / Splat / Catch-all routes](../routing/routing-concepts.md#splat--catch-all-routes)
-- [Authenticated routes](../guide/authenticated-routes.md)
-
-TanStack Router also has a few more features that you might want to explore:
-
-- [Router Context](../guide/router-context.md)
-- [Preloading](../guide/preloading.md)
-- [Pathless Layout Routes](../routing/routing-concepts.md#pathless-layout-routes)
-- [Route masking](../guide/route-masking.md)
-- [SSR](../guide/ssr.md)
-- ... and more!
-
-If you are facing any issues or have any questions, feel free to ask for help in the TanStack Discord.
-
-# Migration from React Router Checklist
-
-**_If your UI is blank, open the console, and you will probably have some errors that read something along the lines of \`cannot use 'useNavigate' outside of context\` . This means there are React Router api’s that are still imported and referenced that you need to find and remove. The easiest way to make sure you find all React Router imports is to uninstall \`react-router-dom\` and then you should get typescript errors in your files. Then you will know what to change to a \`@tanstack/react-router\` import._**
-
-Here is the [example repo](https://github.com/Benanna2019/SickFitsForEveryone/tree/migrate-to-tanstack/router/React-Router)
-
-- [ ] Install Router - \`npm i @tanstack/react-router\` (see [detailed installation guide](../how-to/install.md))
-- [ ] **Optional:** Uninstall React Router to get TypeScript errors on imports.
-  - At this point I don’t know if you can do a gradual migration, but it seems likely you could have multiple router providers, not desirable.
-  - The api’s between React Router and TanStack Router are very similar and could most likely be handled in a sprint cycle or two if that is your companies way of doing things.
-- [ ] Create Routes for each existing React Router route we have
-- [ ] Create root route
-- [ ] Create router instance
-- [ ] Add global module in main.tsx
-- [ ] Remove any React Router (\`createBrowserRouter\` or \`BrowserRouter\`), \`Routes\`, and \`Route\` Components from main.tsx
-- [ ] **Optional:** Refactor \`render\` function for custom setup/providers - The repo referenced above has an example - This was necessary in the case of Supertokens. Supertoken has a specific setup with React Router and a different setup with all other React implementations
-- [ ] Set RouterProvider and pass it the router as the prop
-- [ ] Replace all instances of React Router \`Link\` component with \`@tanstack/react-router\` \`Link\` component
-  - [ ] Add \`to\` prop with literal path
-  - [ ] Add \`params\` prop, where necessary with params like so \`params={{ orderId: order.id }}\`
-- [ ] Replace all instances of React Router \`useNavigate\` hook with \`@tanstack/react-router\` \`useNavigate\` hook
-  - [ ] Set \`to\` property and \`params\` property where needed
-- [ ] Replace any React Router \`Outlet\`'s with the \`@tanstack/react-router\` equivalent
-- [ ] If you are using \`useSearchParams\` hook from React Router, move the search params default value to the validateSearch property on a Route definition.
-  - [ ] Instead of using the \`useSearchParams\` hook, use \`@tanstack/react-router\` \`Link\`'s search property to update the search params state
-  - [ ] To read search params you can do something like the following
-    - \`const { page } = useSearch({ from: productPage.fullPath })\`
-- [ ] If using React Router’s \`useParams\` hook, update the import to be from \`@tanstack/react-router\` and set the \`from\` property to the literal path name where you want to read the params object from
-  - So say we have a route with the path name \`orders/$orderid\`.
-  - In the \`useParams\` hook we would set up our hook like so: \`const params = useParams({ from: "/orders/$orderId" })\`
-  - Then wherever we wanted to access the order id we would get it off of the params object \`params.orderId\`
+<!-- ::end:framework -->
 
-# Installation with Esbuild
+If you glossed over these examples or didn't understand something, we don't blame you, because there's so much more to learn to really take advantage of TanStack Router! Let's move on.
 
-[//]: # 'BundlerConfiguration'
+# Installation with Esbuild
 
 To use file-based routing with **Esbuild**, you'll need to install the \`@tanstack/router-plugin\` package.
 
-\`\`\`sh
-npm install -D @tanstack/router-plugin
-\`\`\`
+<!-- ::start:tabs variant="package-manager" mode="dev-install" -->
+
+react: @tanstack/router-plugin
+solid: @tanstack/router-plugin
+
+<!-- ::end:tabs -->
 
 Once installed, you'll need to add the plugin to your configuration.
 
-\`\`\`tsx
-// esbuild.config.js
+<!-- ::start:framework -->
+
+# React
+
+\`\`\`ts title="esbuild.config.js"
 import { tanstackRouter } from '@tanstack/router-plugin/esbuild'
 
 export default {
@@ -555,9 +417,44 @@ export default {
 
 Or, you can clone our [Quickstart Esbuild example](https://github.com/TanStack/router/tree/main/examples/react/quickstart-esbuild-file-based) and get started.
 
-Now that you've added the plugin to your Esbuild configuration, you're all set to start using file-based routing with TanStack Router.
+# Solid
+
+\`\`\`ts title="build.js"
+import * as esbuild from 'esbuild'
+import { solidPlugin } from 'esbuild-plugin-solid'
+import { tanstackRouter } from '@tanstack/router-plugin/esbuild'
+
+const isDev = process.argv.includes('--dev')
+
+const ctx = await esbuild.context({
+  entryPoints: ['src/main.tsx'],
+  outfile: 'dist/main.js',
+  minify: !isDev,
+  bundle: true,
+  format: 'esm',
+  target: ['esnext'],
+  sourcemap: true,
+  plugins: [
+    solidPlugin(),
+    tanstackRouter({ target: 'solid', autoCodeSplitting: true }),
+  ],
+})
+
+if (isDev) {
+  await ctx.watch()
+  const { host, port } = await ctx.serve({ servedir: '.', port: 3005 })
+  console.log(\`Server running at http://\${host || 'localhost'}:\${port}\`)
+} else {
+  await ctx.rebuild()
+  await ctx.dispose()
+}
+\`\`\`
+
+Or, you can clone our [Quickstart Esbuild example](https://github.com/TanStack/router/tree/main/examples/solid/quickstart-esbuild-file-based) and get started.
 
-[//]: # 'BundlerConfiguration'
+<!-- ::end:framework -->
+
+Now that you've added the plugin to your Esbuild configuration, you're all set to start using file-based routing with TanStack Router.
 
 ## Ignoring the generated route tree file
 
@@ -605,7 +502,7 @@ When using the TanStack Router Plugin with Esbuild for File-based routing, it co
 
 If these defaults work for your project, you don't need to configure anything at all! However, if you need to customize the configuration, you can do so by editing the configuration object passed into the \`tanstackRouter\` function.
 
-You can find all the available configuration options in the [File-based Routing API Reference](../../../api/file-based-routing.md).
+You can find all the available configuration options in the [File-based Routing API Reference](../api/file-based-routing.md).
 
 # Installation with Router CLI
 
@@ -614,9 +511,12 @@ You can find all the available configuration options in the [File-based Routing
 
 To use file-based routing with the TanStack Router CLI, you'll need to install the \`@tanstack/router-cli\` package.
 
-\`\`\`sh
-npm install -D @tanstack/router-cli
-\`\`\`
+<!-- ::start:tabs variant="package-manager" mode="dev-install" -->
+
+react: @tanstack/router-cli
+solid: @tanstack/router-cli
+
+<!-- ::end:tabs -->
 
 Once installed, you'll need to amend your scripts in your \`package.json\` for the CLI to \`watch\` and \`generate\` files.
 
@@ -631,6 +531,25 @@ Once installed, you'll need to amend your scripts in your \`package.json\` for t
 }
 \`\`\`
 
+<!-- ::start:framework -->
+
+# Solid
+
+If you are using TypeScript, you should also add the following options to your \`tsconfig.json\`:
+
+\`\`\`json
+{
+  "compilerOptions": {
+    "jsx": "preserve",
+    "jsxImportSource": "solid-js"
+  }
+}
+\`\`\`
+
+With that, you're all set to start using file-based routing with TanStack Router.
+
+<!-- ::end:framework -->
+
 [//]: # 'AfterScripts'
 [//]: # 'AfterScripts'
 
@@ -693,36 +612,56 @@ You can use those settings either at a user level or only for a single workspace
 
 When using the TanStack Router CLI for File-based routing, it comes with some sane defaults that should work for most projects:
 
+<!-- ::start:framework -->
+
+# React
+
 \`\`\`json
 {
   "routesDirectory": "./src/routes",
   "generatedRouteTree": "./src/routeTree.gen.ts",
   "routeFileIgnorePrefix": "-",
-  "quoteStyle": "single"
+  "quoteStyle": "single",
+  "target": "react"
 }
 \`\`\`
 
-If these defaults work for your project, you don't need to configure anything at all! However, if you need to customize the configuration, you can do so by creating a \`tsr.config.json\` file in the root of your project directory.
+# Solid
 
-[//]: # 'TargetConfiguration'
-[//]: # 'TargetConfiguration'
+\`\`\`json
+{
+  "routesDirectory": "./src/routes",
+  "generatedRouteTree": "./src/routeTree.gen.ts",
+  "routeFileIgnorePrefix": "-",
+  "quoteStyle": "single",
+  "target": "solid"
+}
+\`\`\`
 
-You can find all the available configuration options in the [File-based Routing API Reference](../../../api/file-based-routing.md).
+<!-- ::end:framework -->
 
-# Installation with Rspack
+If these defaults work for your project, you don't need to configure anything at all! However, if you need to customize the configuration, you can do so by creating a \`tsr.config.json\` file in the root of your project directory.
+
+You can find all the available configuration options in the [File-based Routing API Reference](../api/file-based-routing.md).
 
-[//]: # 'BundlerConfiguration'
+# Installation with Rspack
 
 To use file-based routing with **Rspack** or **Rsbuild**, you'll need to install the \`@tanstack/router-plugin\` package.
 
-\`\`\`sh
-npm install -D @tanstack/router-plugin
-\`\`\`
+<!-- ::start:tabs variant="package-manager" mode="dev-install" -->
+
+react: @tanstack/router-plugin
+solid: @tanstack/router-plugin
+
+<!-- ::end:tabs -->
 
 Once installed, you'll need to add the plugin to your configuration.
 
-\`\`\`tsx
-// rsbuild.config.ts
+<!-- ::start:framework -->
+
+# React
+
+\`\`\`ts title="rsbuild.config.ts"
 import { defineConfig } from '@rsbuild/core'
 import { pluginReact } from '@rsbuild/plugin-react'
 import { tanstackRouter } from '@tanstack/router-plugin/rspack'
@@ -744,9 +683,34 @@ export default defineConfig({
 
 Or, you can clone our [Quickstart Rspack/Rsbuild example](https://github.com/TanStack/router/tree/main/examples/react/quickstart-rspack-file-based) and get started.
 
-Now that you've added the plugin to your Rspack/Rsbuild configuration, you're all set to start using file-based routing with TanStack Router.
+# Solid
+
+\`\`\`ts title="rsbuild.config.ts"
+import { defineConfig } from '@rsbuild/core'
+import { pluginBabel } from '@rsbuild/plugin-babel'
+import { pluginSolid } from '@rsbuild/plugin-solid'
+import { tanstackRouter } from '@tanstack/router-plugin/rspack'
+
+export default defineConfig({
+  plugins: [
+    pluginBabel({
+      include: /\.(?:jsx|tsx)$/,
+    }),
+    pluginSolid(),
+  ],
+  tools: {
+    rspack: {
+      plugins: [tanstackRouter({ target: 'solid', autoCodeSplitting: true })],
+    },
+  },
+})
+\`\`\`
+
+Or, you can clone our [Quickstart Rspack/Rsbuild example](https://github.com/TanStack/router/tree/main/examples/solid/quickstart-rspack-file-based) and get started.
 
-[//]: # 'BundlerConfiguration'
+<!-- ::end:framework -->
+
+Now that you've added the plugin to your Rspack/Rsbuild configuration, you're all set to start using file-based routing with TanStack Router.
 
 ## Ignoring the generated route tree file
 
@@ -794,22 +758,26 @@ When using the TanStack Router Plugin with Rspack (or Rsbuild) for File-based ro
 
 If these defaults work for your project, you don't need to configure anything at all! However, if you need to customize the configuration, you can do so by editing the configuration object passed into the \`tanstackRouter\` function.
 
-You can find all the available configuration options in the [File-based Routing API Reference](../../../api/file-based-routing.md).
+You can find all the available configuration options in the [File-based Routing API Reference](../api/file-based-routing.md).
 
 # Installation with Vite
 
-[//]: # 'BundlerConfiguration'
-
 To use file-based routing with **Vite**, you'll need to install the \`@tanstack/router-plugin\` package.
 
-\`\`\`sh
-npm install -D @tanstack/router-plugin
-\`\`\`
+<!-- ::start:tabs variant="package-manager" mode="dev-install" -->
+
+react: @tanstack/router-plugin
+solid: @tanstack/router-plugin
+
+<!-- ::end:tabs -->
 
 Once installed, you'll need to add the plugin to your Vite configuration.
 
-\`\`\`ts
-// vite.config.ts
+<!-- ::start:framework -->
+
+# React
+
+\`\`\`ts title="vite.config.ts"
 import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react'
 import { tanstackRouter } from '@tanstack/router-plugin/vite'
@@ -830,12 +798,31 @@ export default defineConfig({
 
 Or, you can clone our [Quickstart Vite example](https://github.com/TanStack/router/tree/main/examples/react/quickstart-file-based) and get started.
 
-> [!WARNING]
-> If you are using the older \`@tanstack/router-vite-plugin\` package, you can still continue to use it, as it will be aliased to the \`@tanstack/router-plugin/vite\` package. However, we would recommend using the \`@tanstack/router-plugin\` package directly.
+# Solid
 
-Now that you've added the plugin to your Vite configuration, you're all set to start using file-based routing with TanStack Router.
+\`\`\`ts title="vite.config.ts"
+import { defineConfig } from 'vite'
+import solid from 'vite-plugin-solid'
+import { tanstackRouter } from '@tanstack/router-plugin/vite'
 
-[//]: # 'BundlerConfiguration'
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    tanstackRouter({
+      target: 'solid',
+      autoCodeSplitting: true,
+    }),
+    solid(),
+    // ...
+  ],
+})
+\`\`\`
+
+Or, you can clone our [Quickstart Vite example](https://github.com/TanStack/router/tree/main/examples/solid/quickstart-file-based) and get started.
+
+<!-- ::end:framework -->
+
+Now that you've added the plugin to your Vite configuration, you're all set to start using file-based routing with TanStack Router.
 
 ## Ignoring the generated route tree file
 
@@ -883,22 +870,26 @@ When using the TanStack Router Plugin with Vite for File-based routing, it comes
 
 If these defaults work for your project, you don't need to configure anything at all! However, if you need to customize the configuration, you can do so by editing the configuration object passed into the \`tanstackRouter\` function.
 
-You can find all the available configuration options in the [File-based Routing API Reference](../../../api/file-based-routing.md).
+You can find all the available configuration options in the [File-based Routing API Reference](../api/file-based-routing.md).
 
 # Installation with Webpack
 
-[//]: # 'BundlerConfiguration'
-
 To use file-based routing with **Webpack**, you'll need to install the \`@tanstack/router-plugin\` package.
 
-\`\`\`sh
-npm install -D @tanstack/router-plugin
-\`\`\`
+<!-- ::start:tabs variant="package-manager" mode="dev-install" -->
+
+react: @tanstack/router-plugin
+solid: @tanstack/router-plugin
+
+<!-- ::end:tabs -->
 
 Once installed, you'll need to add the plugin to your configuration.
 
-\`\`\`tsx
-// webpack.config.ts
+<!-- ::start:framework -->
+
+# React
+
+\`\`\`ts title="webpack.config.ts"
 import { tanstackRouter } from '@tanstack/router-plugin/webpack'
 
 export default {
@@ -913,9 +904,37 @@ export default {
 
 Or, you can clone our [Quickstart Webpack example](https://github.com/TanStack/router/tree/main/examples/react/quickstart-webpack-file-based) and get started.
 
-Now that you've added the plugin to your Webpack configuration, you're all set to start using file-based routing with TanStack Router.
+# Solid
 
-[//]: # 'BundlerConfiguration'
+\`\`\`ts title="webpack.config.ts"
+import { tanstackRouter } from '@tanstack/router-plugin/webpack'
+
+export default {
+  plugins: [
+    tanstackRouter({
+      target: 'solid',
+      autoCodeSplitting: true,
+    }),
+  ],
+}
+\`\`\`
+
+And in the .babelrc (SWC doesn't support solid-js, see [here](https://www.answeroverflow.com/m/1135200483116593182)), add these presets:
+
+\`\`\`tsx
+// .babelrc
+
+{
+  "presets": ["babel-preset-solid", "@babel/preset-typescript"]
+}
+
+\`\`\`
+
+Or, for a full webpack.config.js, you can clone our [Quickstart Webpack example](https://github.com/TanStack/router/tree/main/examples/solid/quickstart-webpack-file-based) and get started.
+
+<!-- ::end:framework -->
+
+Now that you've added the plugin to your Webpack configuration, you're all set to start using file-based routing with TanStack Router.
 
 ## Ignoring the generated route tree file
 
@@ -963,6 +982,6 @@ When using the TanStack Router Plugin with Webpack for File-based routing, it co
 
 If these defaults work for your project, you don't need to configure anything at all! However, if you need to customize the configuration, you can do so by editing the configuration object passed into the \`tanstackRouter\` function.
 
-You can find all the available configuration options in the [File-based Routing API Reference](../../../api/file-based-routing.md).
+You can find all the available configuration options in the [File-based Routing API Reference](../api/file-based-routing.md).
 
 `;