tanstack-start · vercel-labs — скилл для Claude Code: JSON-описание TanStack Start
Учит агента собирать страницы и маршруты TanStack Start из JSON-спеки и связывать их с роутером, лоадерами и метаданными.
Apache-2.0 245 установок ★ 19 802 обновлён 2026-10-24
npx skills add vercel-labs/json-render --skill tanstack-start -a claude-codeЧто делает tanstack-start
Скилл даёт агенту рецепт: как из StartAppSpec получить маршруты, лейауты, head-метаданные и SSR-лоадеры TanStack Start. Внутри — инструкция и примеры кода, приложение он не генерирует целиком.
Пакеты ставятся отдельно: @json-render/core, @json-render/react, @json-render/tanstack-start. В каталоге компонентов нужно развернуть startComponentDefinitions: Slot и Link приходят оттуда, писать для них React-компоненты не требуется. Каждый лейаут обязан содержать элемент Slot, иначе странице некуда вставиться. Динамика описывается как /posts/$slug, сплэт — как /docs/$ с параметром _splat.
Лоадеры TanStack Router работают и на сервере, и в браузере. Если в спеке или именованном лоадере есть ключи API, клиент базы или серверные импорты, getPageData и getHead заворачивают в createServerFn — прямой импорт утащит серверный код в клиентский бандл.
Какие задачи решает
- описать маршруты приложения одним JSON-объектом вместо файлов
- подключить слотовый лейаут с навигацией и общим каркасом
- собрать сплэт-маршрут и достать путь из
_splat - отдать метаданные страницы в head через
getHead - сгенерировать список статических путей из
staticParams
Примеры запросов агенту
- Опиши маршрут
/posts/$slugвStartAppSpecи подключи к нему лоадерpost - Сделай лейаут
mainс элементомSlotи навигацией, страницу положи внутрь слота - Заверни
getPageDataвcreateServerFn, чтобы клиент базы не попал в браузер
Как установить tanstack-start
1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill tanstack-start -a claude-code2Вручную: положить файлы
~/.claude/skills/tanstack-start/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tanstack-start/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill tanstack-start -a codex2Вручную: положить файлы
.agents/skills/tanstack-start/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill tanstack-start -a cursor2Вручную: положить файлы
.cursor/skills/tanstack-start/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vercel-labs/json-render skills/tanstack-start2Вручную: положить файлы
.github/skills/tanstack-start/SKILL.md1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill tanstack-start -a gemini-cli2Командой платформы
gemini skills install https://github.com/vercel-labs/json-render --path skills/tanstack-startВручную: положить файлы
.devin/skills/tanstack-start/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill tanstack-start -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tanstack-start
Как установить tanstack-start в Claude Code?
Выполните npx skills add vercel-labs/json-render --skill tanstack-start -a claude-code. Файл скилла окажется по пути ~/.claude/skills/tanstack-start/SKILL.md.
Что делает tanstack-start?
Объясняет агенту, как собрать приложение TanStack Start из StartAppSpec: маршруты, лейауты со Slot, head-метаданные, SSR-лоадеры и клиентская навигация.
Подойдёт ли скилл приложению на чистом TanStack Router?
Нет. Он про связку с @json-render/tanstack-start и JSON-спеку; в приложении без json-render брать его незачем.
Исходный текст
SKILL.md · Apache-2.0
---
name: tanstack-start
description: Build JSON-defined TanStack Start applications with @json-render/tanstack-start. Use for Start route specs, splat routing, SSR loaders, head metadata, layouts, and client navigation. Do not use for generic TanStack Router apps that do not use json-render.
---
# @json-render/tanstack-start
Use this integration when a TanStack Start app needs complete pages or routes
described by json-render specs.
## Install
```bash
npm install @json-render/core @json-render/react @json-render/tanstack-start
```
## Application Spec
Include the server-safe built-in definitions in the generation catalog. The
renderer supplies their component implementations.
```typescript
import { defineCatalog } from "@json-render/core";
import {
schema,
startComponentDefinitions,
} from "@json-render/tanstack-start/server";
const catalog = defineCatalog(schema, {
components: {
...startComponentDefinitions,
Card: cardDefinition,
Shell: shellDefinition,
Navigation: navigationDefinition,
Home: homeDefinition,
Post: postDefinition,
},
actions: {},
});
```
Then use `StartAppSpec` and TanStack Router route patterns:
```typescript
import type { StartAppSpec } from "@json-render/tanstack-start";
export const spec: StartAppSpec = {
metadata: {
title: { default: "Site", template: "%s | Site" },
},
layouts: {
main: {
root: "shell",
elements: {
shell: { type: "Shell", props: {}, children: ["nav", "slot"] },
nav: { type: "Navigation", props: {}, children: [] },
slot: { type: "Slot", props: {}, children: [] },
},
},
},
routes: {
"/": {
layout: "main",
metadata: { title: "Home" },
page: {
root: "home",
elements: {
home: { type: "Home", props: {}, children: [] },
},
},
},
"/posts/$slug": {
layout: "main",
loader: "post",
staticParams: [{ slug: "hello" }],
page: {
root: "post",
elements: {
post: {
type: "Post",
props: { value: { $state: "/post" } },
children: [],
},
},
},
},
},
};
```
Routes use `/posts/$slug` for named parameters and `/docs/$` for a splat.
Splat loader parameters are slash-delimited strings under `_splat`. Escape
route-key slashes as `~1` when generating RFC 6902 patches.
Every layout needs a `Slot` element. Declare `Slot` and `Link` through
`startComponentDefinitions`; do not require consumers to register React
implementations for them.
## Server Helpers
```typescript
import { createStartApp } from "@json-render/tanstack-start/server";
export const { getPageData, getHead, getStaticPaths } = createStartApp({
spec,
loaders: {
post: async ({ slug }) => ({ post: await getPost(slug as string) }),
},
});
```
State merge precedence is application state, layout state, page state, then
loader data. `getHead` merges app and route metadata into TanStack `meta` and
`links` descriptors. `getStaticPaths` includes static routes plus dynamic
routes with `staticParams`. Convert its strings to `{ path }` objects for
TanStack Start's top-level `pages` plugin option. Loader params are URL-decoded,
while values from `staticParams` are URL-encoded in generated paths.
Route matching treats trailing slashes as optional and accepts encoded or
decoded pathname representations so loader data and metadata resolve the same
static route.
## Route Wiring
```tsx
import { createFileRoute, notFound } from "@tanstack/react-router";
import {
PageRenderer,
StartErrorBoundary,
StartLoading,
StartNotFound,
} from "@json-render/tanstack-start";
import { getHead, getPageData } from "@/lib/json-app";
export const Route = createFileRoute("/$")({
loader: async ({ location }) => {
const data = await getPageData({ pathname: location.pathname });
if (!data) throw notFound();
return data;
},
head: ({ match }) => getHead({ pathname: match.pathname }),
component: () => <PageRenderer {...Route.useLoaderData()} />,
pendingComponent: StartLoading,
errorComponent: StartErrorBoundary,
notFoundComponent: StartNotFound,
});
```
TanStack Router loaders run on both the server and client. If a spec factory or
named loader uses credentials, database clients, or server-only imports, wrap
`getPageData` and `getHead` in a TanStack Start `createServerFn`; do not import
that server code directly into an isomorphic route loader.
## Root Provider
Wrap the root route's `Outlet` with `StartAppProvider`. Render `HeadContent` so
metadata from `getHead` reaches the document.
```tsx
import {
createRootRoute,
HeadContent,
Outlet,
Scripts,
} from "@tanstack/react-router";
import { StartAppProvider } from "@json-render/tanstack-start";
import { spec } from "@/lib/spec";
export const Route = createRootRoute({
component: () => (
<html lang="en">
<head>
<HeadContent />
</head>
<body>
<StartAppProvider
registry={registry}
handlers={handlers}
spec={spec}
>
<Outlet />
</StartAppProvider>
<Scripts />
</body>
</html>
),
});
```
Use `StartLoading`, `StartErrorBoundary`, and `StartNotFound` for TanStack
Router's `pendingComponent`, `errorComponent`, and `notFoundComponent` options.
When `StartAppProvider` receives `spec`, each component selects the matched
route's corresponding fallback. Explicit fallback props override that lookup.
Pass named `$computed` implementations through `StartAppProvider.functions`.
The default error boundary invalidates the router and reruns a failed loader
when the user selects **Try again**.
Import React components from `@json-render/tanstack-start`. Import `schema`,
`createStartApp`, `matchRoute`, `resolveMetadata`, and static path helpers from
`@json-render/tanstack-start/server`.
© vercel-labs · Apache-2.0 · vercel-labs/json-render
Похожие скиллы
Все скиллы по теме «Фронтенд и UI» →Сначала — tanstack-start от других авторов.