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

tanstack-start · vercel-labs — скилл для Claude Code: JSON-описание TanStack Start

Учит агента собирать страницы и маршруты TanStack Start из JSON-спеки и связывать их с роутером, лоадерами и метаданными.

Apache-2.0 245 установок ★ 19 802 обновлён 2026-10-24

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

Что делает 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-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

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 oakoss По TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой. CX Codex +1 156установок tanstack-start-cursorrules-prompt-file PatrickJS Правило tanstack-start-cursorrules-prompt-file для Cursor описывает структуру TanStack Start и типобезопасную разработку с SSR. Активируется в проектах Start, маршрутах TanStack Router и конфигурации Vinxi. CX Codex +1 ★ 41 178звёзд репо react-start TanStack Скилл react-start для Claude Code содержит правила и шаблоны для проектов на TanStack Start с React. Помогает писать изоморфный код, настраивать Vite и связывать серверные функции с UI. CX Codex +1 533установок tanstack-start-best-practices DeckardGer Скилл tanstack-start-best-practices для Claude Code собирает правила и паттерны для full-stack приложений на TanStack Start. Помогает настраивать серверные функции, сессии и потоковый SSR. CX Codex +1 10 000установок start-core TanStack Скилл start-core объясняет базовую структуру TanStack Start: Vite-плагин, роутер, корневой маршрут и серверные функции. Нужен при создании или проверке Start-проекта. CX Codex +1 529установок sentry-tanstack-start-sdk getsentry Скилл sentry-tanstack-start-sdk настраивает Sentry в проектах TanStack Start React: проверяет структуру файлов и подключает трейсинг, отслеживание ошибок и запись сессий. CX Codex +1 2 000установок bun-tanstack-start secondsky Скилл bun-tanstack-start подсказывает агенту, как поднять full-stack приложение на TanStack Start с рантаймом Bun: роутинг, серверные функции, сборка. CX Codex +1 431установок

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

Весь набор →
yaml Потоковый парсер YAML для json-render, который превращает код-фенсы в JSON Patch. Подходит для прогрессивного рендеринга и точечных правок спеки через стрим. CX Codex +1 1 100установок solid Рендерит JSON-spec в реактивные SolidJS компоненты. Управляет состоянием, видимостью элементов, валидацией форм и экшенами через провайдеры и fine-grained реактивность Solid. CX Codex +1 1 100установок xstate Связывает генеративный интерфейс json-render с хранилищем @xstate/store. Управляет состоянием компонентов через атом. CX Codex +1 1 100установок json-render-shadcn Скилл json-render-shadcn для Claude Code добавляет готовые компоненты shadcn/ui в каталоги и веб-интерфейсы json-render. Подключается при работе с @json-render/shadcn. CX Codex +1 257установок devtools-react Скилл devtools-react добавляет панель разработчика в React-приложения с json-render для просмотра спецификаций, редактирования состояния и просмотра таймлайнов действий и потоков. CX Codex +1 215установок devtools-vue Подключает панель инспектора json-render к приложению на Vue. Он активируется при настройке или устранении проблем с @json-render/devtools-vue. CX Codex +1 165установок devtools-svelte Скилл devtools-svelte для Claude Code помогает подключить и настроить инспектор json-render в приложении на Svelte. Активируется при работе с просмотром спецификации, состоянием и событиями. CX Codex +1 158установок devtools-solid Скилл devtools-solid для Claude Code и Cursor, который подключает адаптер отладки в приложениях SolidJS на базе json-render. CX Codex +1 152установок

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

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