tanstack-start · oakoss — скилл для Claude Code: что делает и как установить
Скилл для Claude Code по TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой.
MIT 156 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill tanstack-start -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/tanstack-start/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tanstack-start/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-start -a codex2Вручную: положить файлы
.agents/skills/tanstack-start/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-start -a cursor2Вручную: положить файлы
.cursor/skills/tanstack-start/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/tanstack-start2Вручную: положить файлы
.github/skills/tanstack-start/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-start -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/tanstack-startВручную: положить файлы
.devin/skills/tanstack-start/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-start -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.