blank

Shadcn Admin Template

一个基于现代技术栈的全栈管理后台启动模板，采用 Monorepo 架构，包含前端 React 应用和后端 Hono API 服务。

🚀 特性

• Monorepo 架构: 使用 npm workspaces 管理多包项目
• 现代化技术栈: React 19 + TypeScript + Hono + Tailwind CSS
• 类型安全: 完整的 TypeScript 严格模式配置
• 代码质量: ESLint + Prettier + Husky 代码规范保障
• 开发体验: 热重载、类型检查、代码格式化
• 生产就绪: Docker 容器化部署配置

📦 项目结构

shadcn-admin-template/
├── packages/
│   ├── client/          # 前端管理后台 (React + shadcn/ui)
│   ├── server/          # 后端API服务 (Hono + TypeORM)
│   └── shared/          # 共享代码和类型定义
├── docs/                # 项目文档
├── .vscode/            # 编辑器配置
├── docker/             # Docker 配置
└── scripts/            # 部署脚本

🛠️ 开发环境要求

• Node.js >= 18.0.0
• npm >= 8.0.0
• Git

⚡ 快速开始

安装依赖

npm install

开发模式

启动前后端开发服务器：

npm run dev

前端应用将在 http://localhost:3000 运行 后端API将在 http://localhost:3001 运行

构建生产版本

npm run build

代码检查

# 代码格式检查
npm run lint

# 类型检查
npm run typecheck

# 运行测试
npm run test

📋 可用脚本

• npm run dev - 启动开发环境（前后端）
• npm run build - 构建生产版本
• npm run test - 运行测试
• npm run lint - 代码检查
• npm run typecheck - TypeScript 类型检查

🔧 开发配置

Git Hooks

项目配置了 pre-commit hook，自动运行：

• ESLint 代码检查
• Prettier 代码格式化

编辑器配置

推荐使用 VS Code 并安装推荐扩展：

• ESLint
• Prettier
• TypeScript Hero
• Tailwind CSS IntelliSense

📚 文档

• 架构设计 - 详细的技术架构说明
• 产品需求文档 - 产品功能和需求说明
• 用户故事 - 敏捷开发用户故事

🐳 Docker 开发环境

项目包含完整的 Docker 开发环境配置：

# 启动开发环境
docker-compose -f docker-compose.dev.yml up

📄 许可证

MIT License