docs: push docs

Author: tannerlinsley

docs/cli-reference.md

@@ -0,0 +1,117 @@
+---
+id: cli-reference
+title: CLI Reference
+---
+
+## tanstack create
+
+Create a new TanStack Start project.
+
+```bash
+tanstack create [project-name] [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--integrations <ids>` | Comma-separated integration IDs |
+| `--template <url>` | Template URL or local path |
+| `--package-manager <pm>` | `npm`, `pnpm`, `yarn`, `bun`, `deno` |
+| `--no-tailwind` | Skip Tailwind CSS |
+| `--no-git` | Skip git init |
+| `--no-install` | Skip dependency install |
+| `-y, --yes` | Use defaults, skip prompts |
+| `--target-dir <path>` | Custom output directory |
+| `--integrations-path <path>` | Local integrations (dev) |
+
+```bash
+# Examples
+tanstack create my-app -y
+tanstack create my-app --integrations clerk,drizzle,tanstack-query
+tanstack create my-app --template https://example.com/template.json
+```
+
+---
+
+## tanstack integration
+
+Create custom integrations from existing projects.
+
+### init
+
+Extract integration from current project:
+
+```bash
+tanstack integration init
+```
+
+Creates `.integration/` folder with `info.json` and `assets/`.
+
+### compile
+
+Rebuild after changes:
+
+```bash
+tanstack integration compile
+```
+
+See [Creating Integrations](./creating-integrations.md) for full guide.
+
+---
+
+## tanstack template
+
+Create reusable project presets.
+
+### init
+
+```bash
+tanstack template init
+```
+
+Creates `template-info.json` and `template.json`.
+
+### compile
+
+```bash
+tanstack template compile
+```
+
+See [Templates](./templates.md) for full guide.
+
+---
+
+## tanstack mcp
+
+Start MCP server for AI agents.
+
+```bash
+tanstack mcp [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--sse` | HTTP/SSE mode (default: stdio) |
+| `--port <n>` | SSE port (default: 8080) |
+
+See [MCP Server](./mcp/overview.md) for setup.
+
+---
+
+## Configuration
+
+Projects include `.tanstack.json`:
+
+```json
+{
+  "version": 1,
+  "projectName": "my-app",
+  "framework": "react",
+  "mode": "file-router",
+  "typescript": true,
+  "tailwind": true,
+  "packageManager": "pnpm",
+  "chosenIntegrations": ["tanstack-query", "clerk"]
+}
+```
+
+Used by `integration init` and `template init` to detect changes.

docs/config.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://raw.githubusercontent.com/TanStack/tanstack.com/main/tanstack-docs-config.schema.json",
+  "docSearch": {
+    "appId": "FQ0DQ6MA3C",
+    "apiKey": "10c34d6a5c89f6048cf644d601e65172",
+    "indexName": "tanstack-test"
+  },
+  "sections": [
+    {
+      "label": "Getting Started",
+      "children": [
+        {
+          "label": "Overview",
+          "to": "overview"
+        },
+        {
+          "label": "Installation",
+          "to": "installation"
+        },
+        {
+          "label": "Quick Start",
+          "to": "quick-start"
+        }
+      ]
+    },
+    {
+      "label": "Usage",
+      "children": [
+        {
+          "label": "CLI Reference",
+          "to": "cli-reference"
+        },
+        {
+          "label": "Integrations",
+          "to": "integrations"
+        },
+        {
+          "label": "Templates",
+          "to": "templates"
+        },
+        {
+          "label": "Examples",
+          "to": "examples"
+        }
+      ]
+    },
+    {
+      "label": "Authoring",
+      "children": [
+        {
+          "label": "Creating Integrations",
+          "to": "creating-integrations"
+        }
+      ]
+    },
+    {
+      "label": "MCP Server",
+      "children": [
+        {
+          "label": "Overview",
+          "to": "mcp/overview"
+        },
+        {
+          "label": "Connecting",
+          "to": "mcp/connecting"
+        },
+        {
+          "label": "Tools Reference",
+          "to": "mcp/tools"
+        }
+      ]
+    },
+    {
+      "label": "Help",
+      "children": [
+        {
+          "label": "Troubleshooting",
+          "to": "troubleshooting"
+        }
+      ]
+    }
+  ]
+}

docs/creating-integrations.md

@@ -0,0 +1,169 @@
+---
+id: creating-integrations
+title: Creating Integrations
+---
+
+Integrations add files, dependencies, and code hooks to generated projects.
+
+## Quick Start
+
+```bash
+# 1. Create base project
+tanstack create my-integration-dev -y
+
+# 2. Add your code
+#    - src/integrations/my-feature/
+#    - src/routes/demo/my-feature.tsx
+#    - Update package.json
+
+# 3. Extract integration
+tanstack integration init
+
+# 4. Edit .integration/info.json
+
+# 5. Compile
+tanstack integration compile
+
+# 6. Test
+tanstack create test --integrations my-feature --integrations-path ./.integration
+```
+
+## Structure
+
+```
+my-integration/
+├── info.json        # Metadata (required)
+├── package.json     # Dependencies (optional)
+└── assets/          # Files to copy
+    └── src/
+        ├── integrations/my-feature/
+        └── routes/demo/my-feature.tsx
+```
+
+## info.json
+
+Required fields:
+
+```json
+{
+  "name": "My Feature",
+  "description": "What it does",
+  "type": "integration",
+  "phase": "integration",
+  "category": "tooling",
+  "modes": ["file-router"]
+}
+```
+
+| Field | Values |
+|-------|--------|
+| `type` | `integration`, `toolchain`, `deployment`, `example` |
+| `phase` | `setup`, `integration`, `example` |
+| `category` | `tanstack`, `auth`, `database`, `orm`, `deploy`, `tooling`, `monitoring`, `api`, `i18n`, `cms`, `other` |
+
+Optional fields:
+
+```json
+{
+  "dependsOn": ["tanstack-query"],
+  "conflicts": ["other-feature"],
+  "envVars": [{ "name": "API_KEY", "description": "...", "required": true }],
+  "gitignorePatterns": ["*.cache"]
+}
+```
+
+## Hooks
+
+Inject code into generated projects:
+
+```json
+{
+  "hooks": [
+    {
+      "type": "root-provider",
+      "jsName": "MyProvider",
+      "path": "src/integrations/my-feature/provider.tsx"
+    }
+  ]
+}
+```
+
+| Type | Location | Use |
+|------|----------|-----|
+| `root-provider` | Wraps app in `__root.tsx` | Context providers |
+| `vite-plugin` | `vite.config.ts` | Vite plugins |
+| `devtools` | After app in `__root.tsx` | Devtools |
+| `entry-client` | `entry-client.tsx` | Client init |
+
+## Demo Routes
+
+```json
+{
+  "routes": [
+    {
+      "url": "/demo/my-feature",
+      "name": "My Feature Demo",
+      "path": "src/routes/demo/my-feature.tsx"
+    }
+  ]
+}
+```
+
+## Integration Options
+
+Let users configure the integration:
+
+```json
+{
+  "options": {
+    "database": {
+      "type": "select",
+      "label": "Database",
+      "options": [
+        { "value": "postgres", "label": "PostgreSQL" },
+        { "value": "sqlite", "label": "SQLite" }
+      ],
+      "default": "postgres"
+    }
+  }
+}
+```
+
+Access in EJS templates:
+
+```ejs
+<% if (integrationOption['my-feature']?.database === 'postgres') { %>
+// PostgreSQL code
+<% } %>
+```
+
+## EJS Templates
+
+Files ending in `.ejs` are processed. Available variables:
+
+| Variable | Type | Description |
+|----------|------|-------------|
+| `projectName` | string | Project name |
+| `typescript` | boolean | TS enabled |
+| `tailwind` | boolean | Tailwind enabled |
+| `integrationEnabled` | object | `{ [id]: boolean }` |
+| `integrationOption` | object | `{ [id]: options }` |
+
+File patterns:
+
+| Pattern | Result |
+|---------|--------|
+| `file.ts` | Copied as-is |
+| `file.ts.ejs` | EJS processed |
+| `_dot_gitignore` | Becomes `.gitignore` |
+| `file.ts.append` | Appended to existing |
+
+## Distribution
+
+Host on GitHub or npm, then:
+
+```bash
+tanstack create my-app --integrations-path ./path/to/integrations
+```
+
+To add to official catalog: PR to `integrations/` folder.