TodoList FullStack Template 不仅仅是一个简单的待办事项应用。它是一个生产级、功能完备、跨平台（Web、Mobile、Server） 的项目模板，旨在展示如何使用业界领先的技术栈构建现代化、可扩展且高内聚的应用程序。
本项目是您启动下一个全栈项目的理想脚手架，也是深入学习 Monorepo 架构、TypeScript 前后端实践以及 AI 辅助编程的绝佳范例。
我们采用 PNPM Workspaces 驱动的 Monorepo 架构，将整个项目视为一个统一的、多包的代码库。这种策略带来了无与伦比的优势：
- 极致的代码复用: 在
packages目录中沉淀通用逻辑，如ui组件库、datasource数据源定义和shared工具函数，供所有应用 (apps) 消费。 - 一致的开发体验: 单一的构建、测试和 linting 流程，简化的依赖管理，以及跨项目的原子性提交。
- 清晰的权责边界:
apps专注于特定平台的应用实现，而packages专注于提供高内聚的、可复用的功能模块。
.
├── apps
│ ├── mobile # React Native (Expo) 移动端应用
│ ├── server # NestJS 后端服务
│ └── web # React (Vite) Web 应用
│
├── packages
│ ├── datasource # 数据源层 (e.g., TypeORM 实体, DTOs)
│ ├── shared # 跨端通用工具库 (e.g., 格式化, 常量)
│ └── ui # 共享 React UI 组件库
│
├── .vscode # VSCode 调试与任务配置
├── package.json # Monorepo 根配置
├── pnpm-workspace.yaml # PNPM 工作区定义
└── tsconfig.base.json # 全局 TypeScript 基础配置
| 分类 | 技术 |
|---|---|
| 工作区管理 | PNPM Workspaces |
| 语言 | TypeScript |
| Web 前端 | React, Vite, Zustand |
| 移动端 | React Native, Expo |
| 后端 | NestJS, TypeORM |
| 数据库 | PostgreSQL |
| 开发工具 | ESLint, Prettier, VS Code |
在开始之前，请确保您的开发环境已安装以下软件：
- Node.js:
v18.0或更高版本 - PNPM:
v8.0或更高版本 - PostgreSQL: 运行中的本地或远程实例
-
克隆仓库
git clone https://github.com/Hercules11/fullstack-template-todolist.git cd fullstack-template-todolist -
安装依赖 在项目根目录执行，PNPM 将自动处理所有工作区的依赖关系。
pnpm install
-
配置环境变量 后端服务需要数据库连接信息。
# 进入 server 应用目录 cd apps/server # 复制环境变量模板文件 cp .env.example .env
然后，编辑新创建的
.env文件，填入您的 PostgreSQL 数据库信息。 -
启动开发环境 我们已配置好任务，让您一键启动所有应用。
# 返回根目录 cd ../.. # 该命令将同时启动 web, server 和 mobile 应用的开发服务器 pnpm dev
您也可以单独启动某个应用：
# 仅启动 Web 应用 pnpm --filter @todo-monorepo/web dev # 仅启动后端服务 pnpm --filter nest-typescript-starter start:dev
在根目录可以运行以下核心脚本：
pnpm dev: 并行启动所有apps的开发模式。pnpm build: 构建所有packages和apps以用于生产。pnpm lint: 对整个工作区进行代码风格检查和修复。pnpm test: 运行所有测试。
我们热烈欢迎任何形式的贡献，无论是新功能、Bug 修复还是文档改进。请参考我们的 贡献指南 了解详细流程。
本项目基于 MIT 许可证 发布。