mono-ts： TypeScript 单仓库的最佳实践

mono-ts： TypeScript 单仓库的最佳实践

mono-ts A quest for the perfect TS monorepo setup 项目地址: https://gitcode.com/gh_mirrors/mo/mono-ts

项目介绍

mono-ts 是一个 TypeScript 单仓库（monorepo）的项目模板，旨在为开发者提供一个高效、模块化且易于维护的开发环境。项目利用现代工具和最佳实践，如 Turborepo 进行构建流程的编排，以及 firebase-tools-with-isolate 以支持多包共享代码的 Firebase 部署。mono-ts 适用于 Node.js、Next.js 和 Firebase 的项目，但它的设计理念和方法可以适用于不同的技术栈。

项目技术分析

mono-ts 在技术上追求极致，采用以下关键技术和组件：

• Turborepo：协调构建过程和依赖关系，包括 v2 的监听任务。
• Firebase 部署：利用 firebase-tools-with-isolate 实现多包独立部署。
• Firebase 模拟器：支持热重载的本地开发环境。
• Next.js Web 应用：使用 ShadCN 和 Tailwind CSS。
• 类型安全的 Firestore 代码：适用于 React 和 Node.js。
• ESLint 和 TypeScript 配置：遵循严格类型检查的规则。
• PNPM：用于依赖管理的包管理器。

项目技术应用场景

mono-ts 适用于以下开发场景：

1. 大型项目开发：通过单仓库管理所有项目包，提高协作开发效率。
2. 多环境部署：支持多个 Firebase 函数和服务的独立部署。
3. 快速迭代：利用 Turborepo 的监听任务和 Next.js 的开发服务器，实现快速开发和测试。
4. 类型安全：提供强类型的 Firestore 代码，确保数据的准确性和稳定性。

项目特点

mono-ts 拥有以下显著特点：

• 模块化：通过命名空间和包的划分，实现代码的模块化和重用。
• 灵活配置：虽然项目提供了一套标准配置，但开发者可以根据需要进行调整。
• 易于集成：与 Firebase、ESLint 和 TypeScript 等工具无缝集成。
• 性能优化：使用 PNPM 提高了依赖管理的效率。

安装与使用

安装 mono-ts 非常简单，只需使用 PNPM 包管理器：

corepack enable
corepack prepare pnpm@latest --activate
pnpm install

然后，通过执行以下脚本开始使用项目：

• watch：持续构建所有内容，除了 Web 应用，它有自己的开发服务器。
• emulate：启动 Firebase 模拟器。
• dev：启动 Next.js 开发服务器。

通过以上命令，你的 Web 应用将在 http://localhost:3000 上可用，而模拟器 UI 则在 http://localhost:4000。

单仓库设置

mono-ts 使用特定的命名空间和包结构，便于在单仓库中管理代码：

• 命名空间：使用 @repo 作为命名空间，以便在不同项目中保持一致。
• 包：包括 common（前后端通用代码）和 core（服务端共享代码）。
• 应用：包括基于 Next.js 的 Web 应用。
• 服务：包括 Firebase 函数和服务。

Firebase 集成

mono-ts 与 Firebase 的集成提供了以下功能：

• Demo 项目：使用 demo-mono-ts 作为 Firebase 模拟器项目。
• 部署：使用 firebase-tools-with-isolate 实现单仓库的 Firebase 部署。
• 模拟器：通过 pnpm emulate 命令启动所有 Firebase 模拟器。

总结

mono-ts 是一个功能丰富、高度集成的 TypeScript 单仓库项目模板，适合那些寻求高效开发流程和类型安全实践的开发者。无论你是从事大型项目开发还是快速原型迭代，mono-ts 都能为你提供一个坚实的基础。赶快尝试 mono-ts，提升你的开发体验吧！

mono-ts A quest for the perfect TS monorepo setup 项目地址: https://gitcode.com/gh_mirrors/mo/mono-ts