vibe-coding-template by humanstack Vibe 项目

人类堆推出的全栈 Vibe Coding 启动模板，将 Next.js 前端与 Python FastAPI 后端深度整合，并内置 Supabase 后端服务支持，专门面向 AI 辅助编程场景设计。该模板的目标非常明确：让开发者无需在重复的样板代码上浪费时间和 token，直接借助 AI 编程助手从创意构建可上线的产品。

核心亮点在于其对 AI 编码智能体的深度优化。模板内置了完整的 Cursor Rules 和 AGENTS.md 文件系统，AI 助手能根据当前编辑的文件类型自动应用对应的编码规范和模板指令，无需人工反复提示。规则涵盖 FastAPI、Next.js、Supabase 和大语言模型集成的最佳实践，并内置了生产级代码模式库（如 @api-endpoint-template、@react-component-template 等指令模板），确保 AI 生成的代码结构一致、质量可控。

后端基于 Python FastAPI 构建，提供类型安全的高速 REST API 开发体验。与 Supabase 深度集成，涵盖 Google/LinkedIn/邮箱密码三种认证方式、实时数据库订阅、文件存储及数据库迁移等完整能力。LLM 集成层已抽象化，支持 OpenAI GPT 和 Anthropic Claude 双平台，并内置向量嵌入服务和 Qdrant 向量数据库，可完成语义搜索与文档检索任务，遇到 Qdrant 不可用时还会自动回退到本地内存向量数据库。

前端使用 Next.js（React 框架），支持服务端渲染与路由导航；搭配 Tailwind CSS 实现移动优先的响应式设计；Supabase 客户端已预置，完整认证流程（注册、登录、密码重置）即开即用。

项目支持 Docker + Docker Compose 一键部署，Make 命令行封装了常见开发操作（make dev 启动完整开发环境），配有首次运行引导脚本（first-time.sh）自动检查依赖、配置 API Key、生成 .env 文件，新手也能快速上手。文档还包含详细的认证服务商配置指南。

整体而言，这是一个专为 AI 编程时代打造的全栈工程起点——将 AI 辅助开发的最佳实践固化到模板层面，使团队能专注于业务逻辑本身而非工程配置，是 Vibe Coding 理念落地的标杆级开源项目。