基于 TanStack Start 的全栈应用模板,内置 RBAC、管理后台、国际化、Prisma 数据库等基础能力。
- 框架:TanStack Start + TanStack Router
- UI:React 19 + Radix UI + Tailwind CSS v4 + shadcn/ui
- ORM:Prisma 7 + PostgreSQL
- 认证:Better Auth + RBAC
- 状态管理:TanStack Query
- 表单/校验:React Hook Form + Zod
- 国际化:i18next(支持数据库动态翻译)
- 运行时:Bun(生产)+ PM2
src/
├── routes/ # 文件路由 (TanStack Router)
├── modules/ # 核心业务模块,按领域垂直拆分
├── components/ # 全局共享组件 (ui/ 为 shadcn 原始位)
├── shared/ # 共享 hooks/utils/lib (包含 Query Keys 集中管理)
├── infrastructure/ # 运行时配置、数据库连接、可观测性
├── core/ # 模块契约内核 (module-registry, event-bus)
├── i18n/ # 国际化配置
└── styles/ # 全局样式
详细的项目架构、设计模式和开发规范,请参阅 架构文档。
pnpm install
pnpm db:deploy # 应用数据库迁移
pnpm dev复制 .env.example 为 .env,至少配置:
BETTER_AUTH_SECRET=your-secret-key-here-min-32-chars
BETTER_AUTH_URL=http://localhost:3000
DATABASE_URL=postgresql://user:password@localhost:5432/start_basicpnpm dev
pnpm build
pnpm start # 生产服务器 (bun)
pnpm lint
pnpm typecheck
pnpm test
pnpm baseline # lint + typecheck + test + build数据库相关:pnpm db:merge / db:gen / db:migrate / db:deploy / db:seed。
登录后访问 /settings,可修改当前账号的显示名称和头像地址。头像支持公开可访问的 HTTP(S) 图片地址,清空后使用名称缩写。登录邮箱只读;修改通过 Better Auth 的当前用户接口保存,并刷新当前用户和会话缓存。保存失败会保留编辑内容,可直接重试或撤销修改。