Bun full-stack 用户管理示例项目。一个 Bun 服务器同时提供 React 页面、TailwindCSS 样式和 REST API,当前数据与认证均为内存 mock 实现。
- Bun + TypeScript
- React 19
- TailwindCSS 4 +
bun-plugin-tailwind - Bun workspaces:
packages/utils、packages/constants - Biome:格式化与 lint
- Bun test:单元测试
bun install
bun run dev默认服务地址:http://localhost:3000
可访问页面:
/:用户管理页面/dashboard:控制面板页面/api/health:健康检查
注意:当前
server/index.ts会构建./src/styles.css,但仓库中暂缺该文件;启动开发服务前需要补齐 Tailwind 入口样式。
bun run dev # 开发服务
bun run start # 生产模式启动 server/index.ts
bun run lint # Biome 检查
bun run lint:fix # Biome 自动修复
bun test # 运行测试
bun test --watch # 测试监听模式当前没有 build 脚本;生产启动依赖 NODE_ENV=production bun run server/index.ts。
server/ Bun 后端入口、配置、middleware、API 路由
src/ React 前端应用与 API client
public/ HTML 入口和静态资源
packages/utils/ workspace 工具函数
packages/constants/ workspace 常量
tests/ Bun test 测试
docs/ 架构、Tailwind、部署、monorepo 等详细文档
用户管理:
GET /api/usersPOST /api/usersGET /api/users/:idPUT /api/users/:idDELETE /api/users/:id
认证:
POST /api/auth/loginPOST /api/auth/registerPOST /api/auth/logoutGET /api/auth/status
其他:
GET /api/health
默认登录账号:
zhangsan@example.com/password123lisi@example.com/password123
- Mock 用户数据位于
server/routers/users.ts,服务重启后会重置。 - Mock 认证数据位于
server/routers/auth.ts,token 仅为演示用途。 - 共享常量和工具通过
@pkg/constants、@pkg/utils引用,路径映射见tsconfig.json。 - 更多背景文档见
docs/;后续协作记忆见AGENTS.md。
MIT