secondsky/claude-skills / plugins/tanstack-start/skills/tanstack-start
tanstack-start
VerifiedTanStack Start (RC) full-stack React with server functions, SSR, Cloudflare Workers. Use for Next.js migration, edge rendering, or encountering hydration, auth, data pattern errors.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.4 KB |
| references/cloudflare-hosting-and-env.md | markdown | 2.6 KB |
| references/devtools-and-llm-support.md | markdown | 1.2 KB |
| references/execution-and-auth.md | markdown | 2.1 KB |
| references/navigation-and-preloading.md | markdown | 1.6 KB |
| references/quickstart-and-layout.md | markdown | 2.8 KB |
| references/rendering-modes.md | markdown | 2.0 KB |
| references/routing-and-data-loading.md | markdown | 2.3 KB |
| references/server-functions-and-middleware.md | markdown | 2.9 KB |
| scripts/bootstrap-cloudflare-start.sh | script | 1.1 KB |
references/cloudflare-hosting-and-env.md
View on GitHub# Cloudflare Hosting + Environment Management
## Workers Setup (vite-plugin)
```ts
// vite.config.ts
import { defineConfig } from 'vite'
import { tanstackStart } from '@tanstack/react-start/plugin/vite'
import { cloudflare } from '@cloudflare/vite-plugin'
import viteReact from '@vitejs/plugin-react'
export default defineConfig({
plugins: [
cloudflare({ viteEnvironment: { name: 'ssr' } }),
tanstackStart(),
viteReact(),
],
})
```
```json
// wrangler.jsonc
{
"$schema": "./node_modules/wrangler/config-schema.json",
"name": "tanstack-start-app",
"compatibility_date": "2025-09-02",
"compatibility_flags": ["nodejs_compat"],
"main": "@tanstack/react-start/server-entry",
"observability": { "enabled": true }
}
```
Package scripts (Cloudflare docs recommendation):
```json
{
"scripts": {
"dev": "vite dev",
"build": "vite build && tsc --noEmit",
"preview": "vite preview",
"deploy": "npm run build && wrangler deploy",
"cf-typegen": "wrangler types"
}
}
```
## Bindings
- Declare KV/R2/D1/Secrets in `wrangler.jsonc` (`kv_namespaces`, `d1_databases`, `r2_buckets`, `vars`).
- Start exposes bindings to server handlers via the `env` argument when using `createStartHandler` or in the `context` passed to server functions/routes. Keep client code on `import.meta.env`.
## Environment Variables Rules
- Server: use `process.env.SECRET_NAME` or `env.SECRET_NAME` (Workers bindings). No prefix required.
- Client: only `import.meta.env.VITE_*` is available; anything else is stripped at build.
- Load order: `.env.local` → `.env.production`/`.env.development` → `.env`.
- Add `src/env.d.ts` to type `import.meta.env` and prevent typos.
## Tailwind CSS (v4) + Paths
```ts
// vite.config.ts (Tailwind v4)
import tailwindcss from '@tailwindcss/vite'
export default defineConfig({
plugins: [
cloudflare({ viteEnvironment: { name: 'ssr' } }),
tanstackStart(),
viteReact(),
tailwindcss(),
],
})
```
- Create `app/styles/app.css` with `@import 'tailwindcss';` and link in `__root.tsx` using `?url`.
- Enable TS path aliases with `vite-tsconfig-paths` to keep imports short (`@/lib/db`). Add to `plugins` and `tsconfig.json` `paths`.
## Deployment Checklist
- `wrangler login` once per machine; CI uses `CLOUDFLARE_API_TOKEN`.
- `npm run cf-typegen` after adding bindings to keep types in sync.
- For streaming/server functions on Workers, keep `cloudflare({ viteEnvironment: { name: 'ssr' } })` first in plugins so fetch handler binds correctly.
- If using prerender + static server functions, ensure KV/R2 assets bucket is configured to serve generated JSON alongside HTML.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |