VibeStart

产品简介

VibeStart（vibestart.net）是一款面向 AI 编程时代的全栈 TypeScript 项目组装工具。它的口号是"Compose. Verify. Ship."——在网页工作室里逐层挑选技术栈、复制它生成的终端命令，或者直接在终端回答提示，几秒钟得到一个为 AI coding agent 深度优化、内置类型安全、lint 与测试的最新可验证项目。核心理念：与 AI 协作时，难点很少在项目第一天，而在第三十天——功能堆积、结构侵蚀、每次修复引入新 bug；VibeStart 给 agent 也给你一个更好的起点：经过审慎选择的当代最佳实践栈，以及一个"让 agent 在里面写出好代码"的代码库。

核心功能

• 分层组装技术栈：应用层（React SPA/TanStack Router、TanStack Start、Next.js）、桌面（Electron）、后端（Hono 或框架自带）、API（oRPC/OpenAPI/无）、数据库（PostgreSQL/SQLite + Drizzle）、认证（Better Auth）、部署（Docker）、UI（shadcn + Tailwind 4）、工具链（Vite+、Oxlint、Knip、Vitest、Playwright、AGENTS.md）逐层自由组合
• Agent Skill 集成：npx skills add VinkyDev/vibestart --skill vibestart 一键把 vibestart skill 装进 Claude Code、Codex、Cursor 等任意 coding agent，由 agent 自己选栈、建项目，后续还能让它加能力或升级模板
• 组合验证与指纹：每次发版前，所有受支持组合都会被生成、安装、类型检查、lint、测试、浏览器测试与构建，结果带指纹记录在 verification.json 中，CLI 创建项目时展示该指纹
• 一键升级：upgrade 命令对比原始模板、你的项目与新模板，写入前先预览差异；模板文件接受更新，你写的业务代码保持原样
• 组合冲突拒绝：每个技术是带自身文件、依赖与约束的"集成件"，无法工作的组合会被直接拒绝，并给出原因与最小修正方案

特色优势

技术栈只选当代标准或明确在成为标准者：TypeScript 7、React 19 + React Compiler、Drizzle ORM 1.0、Oxlint/Oxfmt、Vite+ 单一工具链；开源、无厂商锁定、每个能力只用一个库，当更好的工具成为标准时模板整体迁移。项目自带 AGENTS.md 明确"每次改动改在哪、怎么改"，类型从数据库 schema 一路穿透到页面、无代码生成步骤，外部数据用 Zod 校验；vp run ready 按速度排序依次跑类型、lint、测试，几秒内报告错误。测试只保留有价值的：整流程 e2e、每个 API 操作对真实数据库的集成测试、只有真实分支逻辑才写单元测试。生成的项目就是普通仓库，不托管你的应用、不迁移生产数据、不隐藏代码，对 VibeStart 无运行时依赖。

应用场景

• 用 AI 快速起新项目：把组装好的命令连同一句话需求粘给 Claude Code/Codex，由 agent 落地整个仓库
• 团队规范统一：以验证过的组合与 AGENTS.md 为底座，让多个 agent 产出风格一致的代码
• 老项目技术栈升级：用 upgrade 对比模板演进，安全引入新标准而不覆盖自有业务代码
• 教学与演示：课堂上现场组装全栈项目，展示类型安全、测试与 lint 的完整闭环

适用人群

与 AI 编程代理深度协作的全栈开发者、需要统一团队代码规范的技术负责人、独立开发者与初创团队（希望第一天就拿到生产级结构），以及 TypeScript 技术栈的教育者与布道者。

出品方

VinkyDev 开源项目，CLI 以 vibestart-cli 发布在 npm（npmjs.com/package/vibestart-cli），持续集成跑在 GitHub Actions，开源协议见仓库 LICENSE；官方文档站含快速开始、选栈指南、CLI 参考与架构说明。

更新动态

项目保持活跃维护，技术栈随标准演进滚动更新（模板会移除被淘汰的旧方案）；每条 CI 流水线验证组合可用性，web studio（vibestart.net/studio）提供可视化选栈。CLI 支持 --framework/--backend/--database 等旗标跳过交互、--list 列出全部合法组合、--dry-run 只解析不落盘、--json 输出机器可读结果，包管理器支持 pnpm 与 Bun。

官网链接

官网：https://vibestart.net （工作室、文档 https://vibestart.net/docs 与 "Why vibestart" 说明） GitHub：https://github.com/VinkyDev/vibestart npm：https://www.npmjs.com/package/vibestart-cli