开源项目分享：VibeAny —— 生产级全栈 AI 应用启动模板

本文介绍 VibeAny，一个基于 TanStack Start + React 19 的生产级全栈 AI 应用启动模板，内置认证、支付、AI 聊天、国际化等功能，让你从想法到上线只需数小时。

项目简介

VibeAny 是一款由 jiahao-jayden 开发的开源全栈启动模板，使用 TypeScript 编写，采用 Apache 2.0 开源协议。该项目专为现代 Vibe Coding 打造，旨在解决开发者在构建新产品时反复编写样板代码、重建基础设施的痛点。

只需 10-20 分钟配置，即可获得完整的认证系统、多供应商 AI 聊天、支付集成、积分系统、企业级落地页、管理后台、博客和文档系统。

核心特性

完整认证系统

• 邮箱密码登录
• Google/GitHub OAuth
• 魔法链接登录
• 邮箱验证（Better Auth）

AI 聊天功能

• Vercel AI SDK 驱动
• 支持 12 个供应商、100+ 模型
• OpenAI、Claude、Gemini、DeepSeek、Grok 等
• 流式响应支持

支付集成

• Stripe、Creem、PayPal
• 微信支付、支付宝
• 支持订阅和一次性付款

积分系统

• Token 计费机制
• FIFO 消耗策略
• 每日奖励、注册赠送

内容系统

• MDX 博客系统
• Fumadocs 文档系统
• 变更日志与路线图
• 全文搜索支持

管理后台

• 用户管理
• 系统动态配置
• 角色权限管理

国际化

• Intlayer 类型安全国际化
• 内置中英文支持
• 编译时捕获翻译错误

技术栈

安装指南

前置要求

• Node.js 20+
• pnpm 9+
• PostgreSQL 数据库

快速开始

1. 克隆并安装：

git clone https://github.com/jiahao-jayden/vibe-any-tanstack.git
cd vibe-any
pnpm install

2. 配置环境变量：

cp .env.example .env.local

应用支持零配置启动——落地页、博客和文档无需数据库即可运行。

3. 初始化数据库（可选）：

pnpm db:push

4. 启动开发服务器：

pnpm dev

打开 http://localhost:3377

项目结构

src/
├── actions/          # 服务端 Actions
├── config/           # 站点配置、国际化内容、动态配置
├── db/               # Drizzle Schema
├── integrations/     # RBAC 检查器、存储、TanStack Query、AI
├── routes/
│   ├── api/          # API 路由
│   └── {-$locale}/   # 带国际化前缀的页面路由
│       ├── _main/
│       │   ├── _landing/   # 落地页
│       │   ├── admin/      # 管理后台
│       │   └── chat/       # AI 聊天
│       ├── docs/     # 文档
│       └── login/    # 登录页
├── services/         # 业务逻辑
└── shared/
    ├── components/   # UI 组件
    ├── context/      # React Context
    ├── hooks/        # 自定义 Hooks
    ├── lib/          # 工具函数
    ├── middleware/   # 路由中间件
    ├── model/        # 数据库查询函数
    └── types/        # TypeScript 类型

部署方式

Docker 部署

docker build -t vibe-any .
docker run -d -p 3000:3000 vibe-any

Node.js 部署

pnpm build
node .output/server/index.mjs

支持 Vercel、Railway、Fly.io、VPS 等所有 Node.js 托管平台。

使用场景

场景 1：AI SaaS 产品

基于 VibeAny 快速搭建 AI 聊天 SaaS 产品：

1. 配置 AI 供应商 API Key
2. 设置支付渠道
3. 自定义落地页品牌
4. 部署上线

场景 2：技术博客 + 文档

利用内置的博客和文档系统：

1. 编写 MDX 博客文章
2. 使用 Fumadocs 编写产品文档
3. 开启国际化支持
4. 零数据库配置即可运行

场景 3：企业官网

使用企业级落地页组件：

• Hero 区域
• 功能介绍
• 用户评价
• FAQ
• CTA 行动召唤

全部可配置，SEO 友好。

架构设计

浏览器
  ↓
前端 (TanStack Router + React 19 + shadcn/ui)
  ↓
后端 (TanStack Start + Vite + Nitro)
  ├── Better Auth (认证)
  ├── RBAC 中间件 (权限)
  └── 业务逻辑 Services
  ↓
数据层
  ├── PostgreSQL + Drizzle ORM
  └── S3 兼容存储
  ↓
外部服务
  ├── AI Providers
  ├── Resend / SMTP (邮件)
  ├── GitHub / Google OAuth
  └── Stripe / PayPal (支付)

功能模块详解

认证系统

基于 Better Auth 实现，支持多种登录方式，RBAC 权限控制支持权限继承。

AI 集成

通过 Vercel AI SDK 统一接入 12 个 AI 供应商，100+ 模型，支持流式响应和工具调用。

支付系统

集成多种支付方式，支持订阅制和一次性付款，完整的 Webhook 处理。

国际化

使用 Intlayer 实现类型安全国际化，翻译错误在编译时捕获，支持路由前缀国际化。

注意事项

• 零配置启动模式：落地页、博客、文档无需数据库
• 完整功能需要配置 DATABASE_URL 和 BETTER_AUTH_SECRET
• 详细配置指南请参考官方文档

项目链接

• GitHub 仓库：https://github.com/jiahao-jayden/vibe-any-tanstack
• 官方文档：https://vibeany.dev/docs
• 演示视频：YouTube
• 官方网站：https://vibeany.dev
• Discord 社区：https://discord.gg/FQ2TAHh6
• 许可证：Apache License 2.0