feat: setup docs

Author: mxvsh

biome.json

@@ -21,7 +21,7 @@
 	},
 	"overrides": [
 		{
-			"includes": ["**/*.spec.ts", "**/*.test.ts"],
+			"includes": ["**/*.spec.ts", "**/*.test.ts", "**/*.gen.ts"],
 			"linter": {
 				"rules": {
 					"suspicious": {

docs/.gitignore

@@ -0,0 +1,10 @@
+node_modules
+
+.DS_Store
+.cache
+.vercel
+.output
+.nitro
+/build/
+
+.tanstack

docs/README.md

@@ -0,0 +1,14 @@
+# docs
+
+This is a Tanstack Start application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+
+Run development server:
+
+```bash
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```

docs/content/index.mdx

@@ -0,0 +1,34 @@
+---
+title: Hello World
+description: Your favourite docs framework.
+icon: Rocket
+---
+
+Hey there! Fumadocs is a docs framework built for Next.js, but do you know it also works on Tanstack Start?
+
+## Heading
+
+Hello World!
+
+<Cards>
+  <Card
+    title="Learn more about Tanstack Start"
+    href="https://tanstack.com/start"
+  />
+  <Card title="Learn more about Fumadocs" href="https://fumadocs.vercel.app" />
+</Cards>
+
+### CodeBlock
+
+```ts
+console.log('Hello World');
+```
+
+#### Table
+
+| Head                            | Description                         |
+| ------------------------------- | ----------------------------------- |
+| `hello`                         | Hello World                         |
+| very **important**              | Hey                                 |
+| _Surprisingly_                  | Fumadocs                            |
+| very long text that looks weird | hello world hello world hello world |

docs/content/test.mdx

@@ -0,0 +1,12 @@
+---
+title: Test
+description: This is another page
+---
+
+Hello World again!
+
+## Installation
+
+```npm
+npm i fumadocs-core fumadocs-ui
+```

docs/package.json

@@ -0,0 +1,34 @@
+{
+	"name": "example-tanstack-start",
+	"private": true,
+	"sideEffects": false,
+	"type": "module",
+	"scripts": {
+		"dev": "vite dev",
+		"build": "vite build && tsc --noEmit",
+		"start": "node .output/server/index.mjs"
+	},
+	"dependencies": {
+		"@tanstack/react-router": "^1.131.30",
+		"@tanstack/react-router-devtools": "^1.131.30",
+		"@tanstack/react-start": "^1.131.30",
+		"fumadocs-core": "15.7.8",
+		"fumadocs-mdx": "11.8.3",
+		"fumadocs-ui": "15.7.8",
+		"lucide-static": "^0.542.0",
+		"react": "^19.1.1",
+		"react-dom": "^19.1.1",
+		"tailwind-merge": "^3.3.1",
+		"vite": "^7.1.3"
+	},
+	"devDependencies": {
+		"@tailwindcss/vite": "^4.1.12",
+		"@types/node": "^24.3.0",
+		"@types/react": "^19.1.12",
+		"@types/react-dom": "^19.1.9",
+		"@vitejs/plugin-react": "^5.0.2",
+		"tailwindcss": "^4.1.12",
+		"typescript": "^5.9.2",
+		"vite-tsconfig-paths": "^5.1.4"
+	}
+}

docs/source.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig, defineDocs } from "fumadocs-mdx/config";
+
+export const docs = defineDocs({
+	dir: "content",
+});
+
+export default defineConfig();

docs/source.generated.ts

@@ -0,0 +1,27 @@
+/// <reference types="vite/client" />
+import { fromConfig } from "fumadocs-mdx/runtime/vite";
+import type * as Config from "./source.config";
+
+export const create = fromConfig<typeof Config>();
+
+export const docs = {
+	doc: create.doc(
+		"docs",
+		import.meta.glob(["./**/*.{mdx,md}"], {
+			query: {
+				collection: "docs",
+			},
+			base: "/content",
+		}),
+	),
+	meta: create.meta(
+		"docs",
+		import.meta.glob(["./**/*.{json,yaml}"], {
+			import: "default",
+			query: {
+				collection: "docs",
+			},
+			base: "/content",
+		}),
+	),
+};

docs/src/components/not-found.tsx

@@ -0,0 +1,28 @@
+import { Link } from "@tanstack/react-router";
+import { HomeLayout } from "fumadocs-ui/layouts/home";
+
+export function NotFound() {
+	return (
+		<HomeLayout
+			nav={{
+				title: "Tanstack Start",
+			}}
+			className="text-center py-32 justify-center"
+		>
+			<div className="flex flex-col items-center gap-4">
+				<h1 className="text-6xl font-bold text-fd-muted-foreground">404</h1>
+				<h2 className="text-2xl font-semibold">Page Not Found</h2>
+				<p className="text-fd-muted-foreground max-w-md">
+					The page you are looking for might have been removed, had its name
+					changed, or is temporarily unavailable.
+				</p>
+				<Link
+					to="/"
+					className="mt-4 px-4 py-2 rounded-lg bg-fd-primary text-fd-primary-foreground font-medium text-sm hover:opacity-90 transition-opacity"
+				>
+					Back to Home
+				</Link>
+			</div>
+		</HomeLayout>
+	);
+}

docs/src/lib/layout.shared.tsx

@@ -0,0 +1,9 @@
+import type { BaseLayoutProps } from "fumadocs-ui/layouts/shared";
+
+export function baseOptions(): BaseLayoutProps {
+	return {
+		nav: {
+			title: "Tanstack Start",
+		},
+	};
+}