docs: add TanStack Start docs

Author: WiXSL

docs/TanStackStart.md

@@ -0,0 +1,69 @@
+---
+layout: default
+title: "React-admin With TanStack Start"
+---
+
+# React-admin With TanStack Start
+
+React-admin supports [TanStack Router](https://tanstack.com/router/latest) as an alternative to react-router. This allows you to use react-admin in a TanStack Start application.
+
+## Setting Up TanStack Start
+
+Let's start by creating a new TanStack Start project. Run the following command:
+
+```bash
+npm create @tanstack/start@latest
+```
+
+This script will ask you for more details about your project. Follow the prompts, then move into the project directory.
+
+## Setting Up React-Admin In TanStack Start
+
+Add the `react-admin` and `ra-router-tanstack` packages, as well as a data provider package. In this example, we'll use `ra-data-json-server` to connect to a test API provided by [JSONPlaceholder](https://jsonplaceholder.typicode.com).
+
+```bash
+cd tanstack-start-admin
+npm install react-admin ra-router-tanstack ra-data-json-server
+# or
+yarn add react-admin ra-router-tanstack ra-data-json-server
+```
+
+## Adding React-Admin In A Route
+
+Create a new route at `/admin` and render react-admin there. TanStack Start uses file-based routing, so create `src/routes/admin.tsx` (or the equivalent routes directory in your template) with the following content:
+
+```tsx
+// in src/routes/admin.tsx
+import { createFileRoute } from '@tanstack/react-router';
+import { Admin, Resource, ListGuesser } from 'react-admin';
+import jsonServerProvider from 'ra-data-json-server';
+import { tanStackRouterProvider } from 'ra-router-tanstack';
+
+const dataProvider = jsonServerProvider('https://jsonplaceholder.typicode.com');
+
+export const Route = createFileRoute('/admin')({
+    component: AdminRoute,
+});
+
+function AdminRoute() {
+    return (
+    <Admin
+        dataProvider={dataProvider}
+        routerProvider={tanStackRouterProvider}
+        basename="/admin"
+    >
+        <Resource name="posts" list={ListGuesser} />
+        <Resource name="comments" list={ListGuesser} />
+    </Admin>
+    );
+}
+
+```
+
+**Tip**: Don't forget to set the `<Admin basename>` prop, so that react-admin generates links relative to the `/admin` subpath.
+
+You can now start the app in `development` mode with `npm run dev`. The admin should render at `/admin` on your dev server.
+
+## Next Steps
+
+For standalone vs embedded setups, see the [TanStack Router Integration](./TanStackRouter.md).

docs/navigation.html

@@ -16,6 +16,7 @@
   <li {% if page.path == 'Remix.md' %} class="active" {% endif %}><a class="nav-link" href="./Remix.html">Remix</a></li>
   <li {% if page.path == 'ReactRouterFramework.md' %} class="active" {% endif %}><a class="nav-link" href="./ReactRouterFramework.html">React Router Framework</a></li>
   <li {% if page.path == 'Deploy.md' %} class="active beginner" {% endif %}><a class="nav-link" href="./Deploy.html">Deployment</a></li>
+  <li {% if page.path == 'TanStackStart.md' %} class="active" {% endif %}><a class="nav-link" href="./TanStackStart.html">TanStack Start</a></li>
 </ul>
 
 <ul><div>Guides & Concepts</div>