Fullstack Pack

企业级全栈 monorepo 项目模板，专为 Cloudflare Workers 优化。

🚀 快速开始

1. 安装依赖

pnpm install

2. 配置环境变量

复制 .env.example 到 .env 并填写配置：

cp .env.example .env

必需配置：

• DATABASE_URL - PostgreSQL 数据库连接字符串
• JWT_SECRET - JWT 密钥（至少 32 字符）

可选配置：

• ACCELERATE_URL - Prisma Accelerate URL（Cloudflare Workers 推荐）

3. 初始化数据库

pnpm db:push

4. 启动开发服务器

# 同时启动前端和后端
pnpm dev:all

# 单独启动
pnpm dev:web         # Web 应用：http://localhost:8000
pnpm dev:auth-portal # 认证门户：http://localhost:7777
pnpm dev:server      # 后端：http://localhost:8787
pnpm docs:dev        # 文档站点：http://localhost:9000

📁 项目结构

fullstackpack/
├── apps/
│   ├── web/              # 前端：React + Vite + shadcn/ui
│   ├── auth-portal/      # 认证门户：统一登录入口
│   ├── front-template/   # 前端应用模板
│   ├── docs/             # 文档站点：VitePress
│   └── server/           # 后端：Hono + Cloudflare Workers
├── packages/
│   ├── logger/           # 通用日志包
│   └── shared/           # 共享 schemas 和类型
└── pnpm-workspace.yaml

🛠 技术栈

前端

• React 19 + TypeScript + Vite
• shadcn/ui + Tailwind CSS
• TanStack Query + Zustand
• React Router DOM v7

后端

• Hono + Cloudflare Workers
• Prisma 7 + Prisma Accelerate/Adapter
• Zod + JWT + bcryptjs

开发工具

• Vitest（测试）
• pnpm（包管理）
• TypeScript（类型安全）

📝 开发规范

详细开发规范请查看 开发规范

核心原则：

• ⭐ TDD 优先：先写测试，再写代码
• 🎨 UI 组件：必须使用 shadcn/ui
• 📦 包管理：使用 pnpm workspace
• 🔒 类型安全：TypeScript 严格模式

📚 文档导航

• 快速开始 - 项目初始化指南
• 开发指南 - 开发流程和最佳实践
• 部署指南 - Cloudflare 和自托管部署
• 应用文档 - 各应用的详细文档

🤖 LLM 入口

本项目文档支持 LLM 读取，提供以下格式：

• llms.txt - 文档索引（简洁版，适合快速浏览）
• llms-full.txt - 完整文档内容（包含所有文档的详细内容）

这些文件遵循 llmstxt.org 标准，方便 LLM 理解和处理文档内容。

📄 许可证

MIT