Better-T-Stack

通用选项

`--yes, -y`

使用默认配置并跳过交互式提示。

create-better-t-stack --yes

`--package-manager <pm>`

选择包管理器：npm、pnpm 或 bun。

create-better-t-stack --package-manager bun

`--install / --no-install`

控制项目创建后的依赖安装。

create-better-t-stack --no-install

`--git / --no-git`

控制 Git 仓库初始化。

create-better-t-stack --no-git

`--yolo`

绕过验证和兼容性检查。不建议正常使用。

create-better-t-stack --yolo

`--verbose`

在项目创建后显示详细的 JSON 格式结果信息。

create-better-t-stack --verbose

`--render-title / --no-render-title`

控制是否显示 ASCII 艺术标题。默认启用。

# 隐藏标题（在 CI 中很有用）
create-better-t-stack --no-render-title

`--directory-conflict <strategy>`

如何处理已存在的非空目标目录：

merge：保留现有文件并合并新文件
overwrite：在搭建前清空目录
increment：创建带后缀的目录（例如 my-app-1）
error：失败而不是提示

# 无需提示直接覆盖现有目录
create-better-t-stack my-app --yes --directory-conflict overwrite

# 如果目录存在，安全地创建新目录名称
create-better-t-stack my-app --yes --directory-conflict increment

`--disable-analytics / --no-disable-analytics`

控制是否收集分析和遥测数据。

# 禁用分析收集
create-better-t-stack --disable-analytics

# 启用分析收集（默认）
create-better-t-stack --no-disable-analytics

分析通过提供使用模式洞察来帮助改进 Better-T-Stack。禁用后，不会收集或传输任何数据。

数据库选项

`--database <type>`

使用的数据库类型：

none：无数据库
sqlite：SQLite 数据库
postgres：PostgreSQL 数据库
mysql：MySQL 数据库
mongodb：MongoDB 数据库

create-better-t-stack --database postgres

`--orm <type>`

与数据库一起使用的 ORM：

none：无 ORM
drizzle：Drizzle ORM（TypeScript 优先）
prisma：Prisma ORM（功能丰富）
mongoose：Mongoose ODM（用于 MongoDB）

create-better-t-stack --database postgres --orm drizzle

`--db-setup <setup>`

数据库托管/设置提供商：

none：手动设置
turso：Turso（SQLite）
d1：Cloudflare D1（SQLite）
neon：Neon（PostgreSQL）
supabase：Supabase（PostgreSQL）
prisma-postgres：通过 Prisma Accelerate 的 Prisma Postgres
mongodb-atlas：MongoDB Atlas
docker：本地 Docker 容器

create-better-t-stack --database postgres --db-setup neon

后端选项

`--backend <framework>`

使用的后端框架：

none：无后端
hono：Hono（快速、轻量级）
express：Express.js（流行、成熟）
fastify：Fastify（快速、基于插件）
elysia：Elysia（Bun 原生）
next：Next.js API 路由
convex：Convex 后端

create-better-t-stack --backend hono

`--runtime <runtime>`

运行时环境：

none：无特定运行时（仅与 convex 或 none 后端一起使用）
bun：Bun 运行时
node：Node.js 运行时
workers：Cloudflare Workers

create-better-t-stack --backend hono --runtime bun

`--api <type>`

API 层类型：

none：无 API 层
trpc：tRPC（类型安全）
orpc：oRPC（OpenAPI 兼容）

create-better-t-stack --api trpc

前端选项

`--frontend <types...>`

前端框架（可指定多个）：

Web 框架：

tanstack-router：React 与 TanStack Router
react-router：React 与 React Router
tanstack-start：React 与 TanStack Start（SSR）
next：Next.js
nuxt：Nuxt（Vue）
svelte：SvelteKit
solid：SolidJS

原生框架：

native-nativewind：React Native 与 NativeWind
native-unistyles：React Native 与 Unistyles

无前端：

none：仅后端项目

# 单个 Web 前端
create-better-t-stack --frontend tanstack-router

# Web + 原生前端
create-better-t-stack --frontend next native-nativewind

# 仅后端
create-better-t-stack --frontend none

身份验证

`--auth <provider>`

选择身份验证提供商：

better-auth：Better-Auth 身份验证（默认）
clerk：Clerk 身份验证（仅与 Convex 后端一起使用）
none：无身份验证

create-better-t-stack --auth better-auth
create-better-t-stack --auth clerk
create-better-t-stack --auth none

注意：

better-auth 需要数据库和后端框架
clerk 仅适用于 Convex 后端
使用 --backend none 或 --database none 时，身份验证自动设置为 none（除非使用 Convex）

附加功能

`--addons <types...>`

要包含的附加功能：

none：无附加功能
pwa：渐进式 Web 应用支持
tauri：桌面应用支持
starlight：Starlight 文档站点
fumadocs：Fumadocs 文档站点
biome：Biome 代码检查和格式化
husky：使用 Husky 的 Git 钩子
turborepo：Turborepo 单体仓库设置
ultracite：Ultracite 配置
oxlint：Oxlint 快速代码检查
ruler：使用 Ruler 集中管理 AI 规则

create-better-t-stack --addons pwa biome husky

示例

`--examples <types...>`

要包含的示例实现：

none：无示例
todo：待办事项应用示例
ai：AI 聊天界面示例

create-better-t-stack --examples todo ai

部署

`--web-deploy <setup>`

Web 部署配置：

none：无部署设置
wrangler：Cloudflare Workers 部署
alchemy：Cloudflare Workers 部署（通过 Alchemy 基础设施即代码）

create-better-t-stack --web-deploy wrangler
create-better-t-stack --web-deploy alchemy

注意： Alchemy 使用 TypeScript 以编程方式定义基础设施。详见使用 Alchemy 的基础设施即代码指南。

`--server-deploy <setup>`

服务器部署配置：

none：无部署设置
wrangler：Cloudflare Workers 部署（当运行时为 workers 时）
alchemy：Cloudflare Workers 部署（当运行时为 workers 时，通过 Alchemy 基础设施即代码）

create-better-t-stack --server-deploy wrangler
create-better-t-stack --server-deploy alchemy