К основному содержанию
скилл CX Codex

tanstack-start · oakoss — скилл для Claude Code: что делает и как установить

Скилл для Claude Code по TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой.

MIT 156 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill tanstack-start -a claude-code
Открыть на GitHub

Что делает tanstack-start

Скилл описывает TanStack Start — фреймворк для React с серверной частью поверх TanStack Router. Внутри справочные таблицы: как объявлять серверные функции через createServerFn(), валидировать вход схемой Zod, читать заголовки запроса и выставлять свои, собирать middleware с зависимостями. Отдельная таблица разводит границы выполнения: что работает только на сервере, что только в браузере, а что в обоих окружениях.

Есть раздел про деплой: Cloudflare Workers через @cloudflare/vite-plugin, Netlify через @netlify/vite-plugin-tanstack-start, Vercel, AWS Lambda, Bun и статика через nitro/vite с нужным пресетом. И список типовых ошибок, из которого видно, на чём спотыкаются чаще всего: сырой fetch вместо серверной функции теряет типы и сериализацию, а на Cloudflare без флага nodejs_compat в wrangler.toml приложение не запустится.

Статус у фреймворка — Release Candidate, API до стабильной 1.0 ещё могут поменяться. Поэтому примеры из скилла сверяйте с текущей документацией @tanstack/react-start, если проект уже на свежей версии.

Какие задачи решает

  • Добавить серверную функцию с валидацией входа через Zod
  • Настроить SSR со стримингом и границами <Suspense>
  • Закрыть группу роутов проверкой авторизации в beforeLoad
  • Собрать middleware для общих задач запроса
  • Выбрать Vite-плагин под деплой на Cloudflare Workers или Vercel

Примеры запросов агенту

  • Добавь createServerFn для списка заказов и проверь вход схемой Zod
  • Настрой деплой на Cloudflare Workers через @cloudflare/vite-plugin, не забудь про nodejs_compat в wrangler.toml
  • Перенеси проверку авторизации в beforeLoad для группы роутов _authenticated

Как установить tanstack-start

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill tanstack-start -a claude-code

2Вручную: положить файлы

~/.claude/skills/tanstack-start/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tanstack-start/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tanstack-start

Как установить tanstack-start в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill tanstack-start -a claude-code. Файл скилла окажется по пути ~/.claude/skills/tanstack-start/SKILL.md.

Что делает tanstack-start?

Это скилл по TanStack Start: серверные функции с валидацией входа, SSR со стримингом, middleware, авторизация в beforeLoad и пресеты деплоя под разные платформы.

Скилл подходит для стабильной версии TanStack Start?

Фреймворк пока в статусе Release Candidate, API до 1.0 ещё меняются. Примеры стоит сверять с актуальной документацией @tanstack/react-start.

Исходный текст

SKILL.md · MIT
---
name: tanstack-start
description: 'Full-stack React framework built on TanStack Router. Type-safe routing, server functions, SSR/streaming, middleware, and multi-platform deployment. Use when building full-stack React apps with SSR, server functions, middleware, or authentication. Use for createServerFn, createMiddleware, beforeLoad, API routes, Cloudflare Workers, Vercel, Netlify deployment.'
license: MIT
metadata:
  author: oakoss
  version: '1.5'
  source: 'https://tanstack.com/start/latest/docs'
user-invocable: false
---

# TanStack Start

Full-stack React framework built on TanStack Router. Type-safe server functions via RPC, SSR/streaming, middleware composition, and deployment to Cloudflare Workers, Vercel, Netlify, AWS Lambda, and more.

> **RC:** TanStack Start is currently in Release Candidate status. APIs may still change before the stable 1.0 release.

**Package:** `@tanstack/react-start`

## Quick Reference

| Pattern                                  | Usage                                                     |
| ---------------------------------------- | --------------------------------------------------------- |
| `createServerFn()`                       | GET (default) — idempotent, cacheable data fetching       |
| `createServerFn({ method: 'POST' })`     | Mutations that change data                                |
| `.inputValidator(zodSchema)`             | Input validation before handler                           |
| `.handler(async ({ data }) => {})`       | Server-side logic with typed input data                   |
| `getRequest()`                           | Access full incoming `Request` inside handler/middleware  |
| `getRequestHeader(name)`                 | Read a single request header by name                      |
| `setResponseHeaders(headers)`            | Set outgoing response headers (caching, cookies)          |
| `useServerFn(fn)`                        | Wrap server function for component use with pending state |
| `createMiddleware().server(fn)`          | Request middleware for cross-cutting concerns             |
| `.middleware([dep])`                     | Compose middleware with dependencies                      |
| `next({ context: {} })`                  | Pass data downstream through middleware chain             |
| `createMiddleware({ type: 'function' })` | Function-level middleware with input validation           |
| `requestMiddleware` in `createStart()`   | Global middleware for all requests (SSR, fns, routes)     |
| `functionMiddleware` in `createStart()`  | Global middleware for server functions only               |
| `createIsomorphicFn()`                   | Different implementations per environment                 |
| `createServerOnlyFn()`                   | Server-only utility — crashes if called from client       |
| `createClientOnlyFn()`                   | Client-only utility — crashes if called from server       |
| `useSession()`                           | Cookie-based session with encryption and secure settings  |
| `session.update()`                       | Update session data                                       |
| `session.clear()`                        | Clear session (logout)                                    |
| `beforeLoad`                             | Auth check before route loads                             |
| `_authenticated.tsx`                     | Pathless layout route for grouped protection              |
| `throw redirect({ to: '/login' })`       | Redirect with return URL                                  |
| `await ensureQueryData()`                | Block SSR on critical data                                |
| `prefetchQuery()`                        | Start fetch, don't block SSR                              |
| `<Suspense>` boundaries                  | Define streaming chunks                                   |
| `head: ({ loaderData }) => ({})`         | Meta tags, Open Graph, favicons                           |
| `head.scripts` + JSON-LD                 | Structured data for LLMO (schema.org)                     |
| `llms.txt` server route                  | AI system guidance file                                   |
| `headers: () => ({...})`                 | ISR / cache-control on route definition                   |
| `server: { handlers: { GET, POST } }`    | API routes on `createFileRoute`                           |
| `ssr: false`                             | Disable SSR for specific routes (SPA mode)                |

## Execution Boundaries

| Function               | Runs On | Client Can Call? | Use For                         |
| ---------------------- | ------- | ---------------- | ------------------------------- |
| `createServerFn()`     | Server  | Yes (RPC stub)   | Data fetching, mutations        |
| `createServerOnlyFn()` | Server  | No (throws)      | Secrets, DB connections         |
| `createClientOnlyFn()` | Client  | N/A              | localStorage, DOM APIs          |
| `createIsomorphicFn()` | Both    | N/A              | Per-environment implementations |

## Deployment (Vite Plugins)

| Platform       | Plugin                                 | Runtime |
| -------------- | -------------------------------------- | ------- |
| Cloudflare     | `@cloudflare/vite-plugin`              | Workers |
| Netlify        | `@netlify/vite-plugin-tanstack-start`  | Node    |
| Vercel         | `nitro/vite` (`preset: 'vercel'`)      | Node    |
| Node.js/Docker | `nitro/vite` (`preset: 'node-server'`) | Node    |
| AWS Lambda     | `nitro/vite` (`preset: 'aws-lambda'`)  | Node    |
| Bun            | `nitro/vite` (`preset: 'bun'`)         | Bun     |
| Static         | `nitro/vite` (`preset: 'static'`)      | None    |

## Common Mistakes

| Mistake                                      | Fix                                                    |
| -------------------------------------------- | ------------------------------------------------------ |
| No `.inputValidator()` on server functions   | Always validate with Zod schemas                       |
| Raw fetch instead of `createServerFn`        | Loses type safety, serialization, and code splitting   |
| Mixing server/client code without boundaries | Use `createServerOnlyFn` / `createClientOnlyFn`        |
| Checking auth in every handler               | Use middleware composition or `beforeLoad`             |
| Awaiting all data in loader                  | Only await critical data, prefetch the rest            |
| `Date.now()` in render                       | Pass timestamp from loader (hydration mismatch)        |
| Missing `nodejs_compat` flag                 | Required in `wrangler.toml` for Cloudflare             |
| GET for mutations                            | Use POST for create/update/delete                      |
| Cookies not forwarded to external APIs       | Use `getRequestHeader()` or `createIsomorphicFn`       |
| `process.env` in loader (runs on both)       | Wrap in `createServerFn` — loaders run client-side too |
| Unvalidated server env vars                  | Validate with Zod in `.server.ts` files                |
| Storing auth tokens in localStorage          | Use HTTP-only cookies via `useSession`                 |
| Exposing raw DB errors to client             | Catch and return user-friendly messages, log details   |
| No structured data for content pages         | Add JSON-LD via `head.scripts` for AI discoverability  |

## Delegation

Use this skill for TanStack Start server functions, middleware, SSR/streaming, route protection, API routes, and deployment configuration. Delegate to `tanstack-router` for file-based routing, search params, and data loading patterns. Delegate to `tanstack-query` for cache management, optimistic updates, and query patterns.

> If the `tanstack-form` skill is available, delegate form state management, validation, and field patterns to it.
> If the `local-first` skill is available, delegate local-first architecture decisions and sync engine selection to it.
> If the `electricsql` skill is available, delegate ElectricSQL shapes, auth configuration, and write patterns to it.
> If the `tanstack-db` skill is available, delegate reactive collections, live queries, and optimistic mutation patterns to it.

## References

- [Server Functions](references/server-functions.md) — createServerFn, useServerFn, validation, auth, request context, response headers, file uploads, streaming, TanStack Query integration
- [Middleware](references/middleware.md) — composition, function-level middleware, route-level middleware, global middleware, logging, rate limiting
- [SSR and Streaming](references/ssr-and-streaming.md) — Suspense, prerendering, ISR, cache-control, hybrid strategies, hydration safety
- [Route Protection](references/route-protection.md) — beforeLoad, pathless layouts, session security, login/logout, header forwarding, Better Auth
- [API Routes](references/api-routes.md) — server handlers, REST patterns, route-level middleware, webhooks, health check, server functions vs server routes
- [Deployment](references/deployment.md) — Vite plugins, adapter comparison, Cloudflare D1/KV/R2 bindings, Docker, prerendering
- [SEO and Head Management](references/seo.md) — head property, meta tags, Open Graph, Twitter Cards, favicons, SEO helper
- [LLM Optimization (LLMO)](references/llmo.md) — JSON-LD structured data, schema.org, llms.txt, machine-readable endpoints, AI citation patterns
- [Error Handling](references/error-handling.md) — discriminated unions, custom error classes, status codes, result types vs try-catch
- [File Organization](references/file-organization.md) — entry points, plugin config, execution boundaries, env validation, .server.ts convention
- [Known Issues](references/known-issues.md) — 10 documented issues with workarounds
- [Query Integration](references/query-integration.md) — Router+Query setup, SSR integration, setupRouterSsrQueryIntegration, DevTools
- [Integration Flows](references/integration-flows.md) — form submission with cache update, infinite scroll, paginated tables, auth-protected routes, error handling
- [Local-First Integration](references/local-first.md) — shape proxy server functions, mixing server-based and local-first data, ElectricSQL deployment
- [Electric Middleware](references/electric-middleware.md) — auth middleware for shape proxies, global middleware config, sendContext, function-level validation

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — tanstack-start от других авторов.

tanstack-start vercel-labs Учит агента собирать страницы и маршруты TanStack Start из JSON-спеки и связывать их с роутером, лоадерами и метаданными. CX Codex +1 245установок tanstack-start jezweb Собирает фуллстек-приложение на TanStack Start и Cloudflare Workers с нуля: SSR, файловый роутинг, D1, авторизация. Даёт рабочий каркас без клонирования шаблона. CX Codex +1 2 500установок tanstack-start tanstack-skills Скилл помогает создавать и сопровождать приложения на фреймворке TanStack Start с потоковым SSR, серверными функциями и маршрутизацией. CX Codex +1 4 000установок tanstack-start-cursorrules-prompt-file PatrickJS Правило tanstack-start-cursorrules-prompt-file для Cursor описывает структуру TanStack Start и типобезопасную разработку с SSR. Активируется в проектах Start, маршрутах TanStack Router и конфигурации Vinxi. CX Codex +1 ★ 41 178звёзд репо clerk-tanstack-patterns clerk Скилл clerk-tanstack-patterns для Claude Code подсказывает, как настроить авторизацию Clerk в TanStack React Start. Активируется при работе с createServerFn, защитой маршрутов через beforeLoad и middleware. CX Codex +1 16 400установок tanstack-start-best-practices DeckardGer Скилл tanstack-start-best-practices для Claude Code собирает правила и паттерны для full-stack приложений на TanStack Start. Помогает настраивать серверные функции, сессии и потоковый SSR. CX Codex +1 10 000установок tanstack-integration-best-practices DeckardGer Скилл tanstack-integration-best-practices для Claude Code задаёт правила стыковки TanStack Query, Router и Start. Описывает потоки данных, SSR с гидратацией и согласование кэша. CX Codex +1 3 100установок react-start TanStack Скилл react-start для Claude Code содержит правила и шаблоны для проектов на TanStack Start с React. Помогает писать изоморфный код, настраивать Vite и связывать серверные функции с UI. CX Codex +1 533установок start-server-core TanStack Скилл start-server-core для Claude Code и ещё пяти платформ, который описывает серверный рантайм TanStack Start: createStartHandler, утилиты запросов и ответов, управление куками через AsyncLocalStorage. CX Codex +1 408установок

Из того же набора106

Весь набор →
accessibility Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров. CX Codex +1 164установок react-performance Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок design-system Скилл design-system для Claude Code собирает дизайн-систему с токенами, темами и архитектурой компонентов. Задаёт структуру для dark mode, CVA-вариантов и доступности. CX Codex +1 160установок zustand Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context. CX Codex +1 158установок pglite Скилл по PGlite: подсказывает агенту, как поднять сборку PostgreSQL 17.4 на WASM в браузере или Node.js, выбрать хранилище и настроить live-запросы. CX Codex +1 156установок tanstack-table Настраивает headless-таблицы TanStack Table v8 в React: серверная пагинация, фильтры и сортировка без циклических ререндеров. CX Codex +1 155установок changesets Скилл changesets помогает вести версии и changelog пакетов в монорепозитории. Он пригодится для согласованных релизов и публикации пакетов в npm. CX Codex +1 154установок opentofu Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой