Skip to main content
tanstack-start-project-setup Initialize a TanStack Start (SSR) project with Vite, server functions, React Query, and proper configuration.
설치로 이동 Skills Marketplace 커뮤니티가 만든 AI 스킬을 발견하고 탐색하세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/agusmdev/fullstack-ai-template --skill tanstack-start-project-setup명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Zip 다운로드 다운로드 중... 이 저장소의 다른 Skills Codebase health scanner and technical debt tracker. Use when the user asks about code quality, technical debt, dead code, large files, god classes, duplicate functions, code smells, naming issues, import cycles, or coupling problems. Also use when asked for a health score, what to fix next, or to create a cleanup plan. Supports 29 languages.
Configure Alembic for async SQLAlchemy migrations with PostgreSQL
Create FastAPI application factory with lifespan, middleware, pagination, and router configuration
name tanstack-start-project-setup description Initialize a TanStack Start (SSR) project with Vite, server functions, React Query, and proper configuration.
TanStack Start Project Setup
Overview
This skill covers initializing a new TanStack Start project with bun package manager. TanStack Start is a full-stack React framework with integrated routing, server-side rendering, and data fetching capabilities.
Step 1: Create Project with CLI
The easiest way to initialize a TanStack Start project is using the official CLI:
bunx create @tanstack/start@latest
Or manually with npm:
npm create @tanstack/start@latest
The CLI will prompt for:
Project name
Optional add-ons (Tailwind CSS, ESLint, Shadcn, TanStack Query, etc.)
Step 2: Navigate to Project
cd your-project-name
Step 3: Install Dependencies
If you created the project with the CLI, install dependencies:
bun install
For Bun deployment, upgrade React to version 19+:
bun install react@19 react-dom@19
Step 4: Create package.json (if building from scratch)
{
"name" : "your-project-name" ,
"version" : "0.1.0" ,
"type"
:
"module"
,
"scripts"
:
{
"dev"
:
"vite"
,
"build"
:
"vite build"
,
"start"
:
"node .output/server/index.mjs"
}
,
"dependencies"
:
{
"@tanstack/react-router"
:
"^1.84.0"
,
"@tanstack/react-start"
:
"^1.84.0"
,
"react"
:
"^19.0.0"
,
"react-dom"
:
"^19.0.0"
,
"vite"
:
"^6.0.0"
}
,
"devDependencies"
:
{
"@types/node"
:
"^22.10.0"
,
"@types/react"
:
"^19.0.0"
,
"@types/react-dom"
:
"^19.0.0"
,
"@vitejs/plugin-react"
:
"^4.3.4"
,
"typescript"
:
"^5.7.2"
,
"vite-tsconfig-paths"
:
"^5.1.4"
}
}
Step 5: Create tsconfig.json {
"compilerOptions" : {
"jsx" : "react-jsx" ,
"moduleResolution" : "Bundler" ,
"module" : "ESNext" ,
"target" : "ES2022" ,
"skipLibCheck" : true ,
"strictNullChecks" : true ,
"baseUrl" : "." ,
"paths" : {
"~/*" : [ "./src/*" ]
}
}
}
Step 6: Create vite.config.ts import { defineConfig } from 'vite'
import { tanstackStart } from '@tanstack/react-start/plugin/vite'
import viteReact from '@vitejs/plugin-react'
import tsconfigPaths from 'vite-tsconfig-paths'
export default defineConfig ({
server : {
port : 3000 ,
},
plugins : [
tsconfigPaths (),
tanstackStart (),
viteReact (),
],
})
For Bun deployment, add Nitro preset:
import { defineConfig } from 'vite'
import { tanstackStart } from '@tanstack/react-start/plugin/vite'
import { nitro } from 'nitro/vite'
import viteReact from '@vitejs/plugin-react'
export default defineConfig ({
plugins : [
tanstackStart (),
nitro ({ preset : 'bun' }),
viteReact (),
],
})
With custom routes directory (App Router style):
import { defineConfig } from 'vite'
import { tanstackStart } from '@tanstack/react-start/plugin/vite'
import viteReact from '@vitejs/plugin-react'
import tsconfigPaths from 'vite-tsconfig-paths'
export default defineConfig ({
server : {
port : 3000 ,
},
plugins : [
tsconfigPaths (),
tanstackStart ({
srcDirectory : 'src' ,
router : {
routesDirectory : 'app' ,
},
}),
viteReact (),
],
})
Step 7: Create Directory Structure mkdir -p src/{routes,types}
mkdir -p public
touch src/router.tsx
Standard project structure:
your-project-name/
├── src/
│ ├── routes/ # File-based routing
│ │ └── __root.tsx # Root layout
│ ├── types/ # TypeScript types
│ ├── router.tsx # Router configuration
│ └── routeTree.gen.ts # Generated route tree (auto-generated)
├── public/ # Static assets
├── vite.config.ts # Vite configuration
├── tsconfig.json # TypeScript configuration
├── package.json # Dependencies and scripts
└── .gitignore
Step 8: Create Root Route Create src/routes/__root.tsx:
import { createRootRoute, Outlet } from '@tanstack/react-router'
export const Route = createRootRoute ({
component : () => (
<html >
<head >
<meta charSet ="UTF-8" />
<meta name ="viewport" content ="width=device-width, initial-scale=1.0" />
<title > TanStack Start App</title >
</head >
<body >
<Outlet />
</body >
</html >
),
})
Step 9: Create Router Configuration import { createRouter } from '@tanstack/react-router'
import { routeTree } from './routeTree.gen'
export const router = createRouter ({ routeTree })
declare module '@tanstack/react-router' {
interface Register {
router : typeof router
}
}
Step 10: Start Development Server The application will be available at http://localhost:3000.
Verification
Development server starts without errors
Navigate to http://localhost:3000 and see the TanStack Start welcome page
TypeScript compilation works: bun run build
Route tree is auto-generated in src/routeTree.gen.ts
Notes
TanStack Start uses file-based routing in the src/routes/ directory
The route tree is automatically generated by Vite plugin
Always use bunx or bun run for commands
For Bun deployment, ensure React 19+ is installed
Server functions can be defined with createServerFn
TanStack Query integration is optional but recommended
Next Steps
Add routes in src/routes/ directory
Configure TanStack Query (see tanstack-react-query-setup skill)
Set up Tailwind CSS and shadcn/ui (see tanstack-shadcn-setup skill)
Add server functions for data fetching (see tanstack-start-server-functions skill)