超棒的 NestJS 样板项目,TypeScript,Postgres,TypeORM
一个面向注重大规模代码结构的团队的企业级 NestJS 启动模板。 内置 CQRS、严格的 TypeScript、JWT 认证(RS256)以及多运行时支持——全部配置零漂移。
# 1. Clone
npx degit NarHakobyan/awesome-nest-boilerplate my-nest-app
cd my-nest-app
# 2. Configure
cp .env.example .env
# Set DB_HOST, DB_PORT, DB_USERNAME, DB_PASSWORD, DB_DATABASE
# Paste your JWT_PRIVATE_KEY and JWT_PUBLIC_KEY (see .env.example for examples)
# 3. Install & run
pnpm install
pnpm start:dev打开 http://localhost:3000。API 文档位于 /documentation。
更倾向于开箱即用的数据库?先运行
Docker-compose up -d postgres。
| CQRS — 命令、查询、处理器 | JWT 认证(RS256) — 登录、注册、RBAC | TypeORM + PostgreSQL — 实体、迁移 |
严格 TypeScript — 无 any、ESM、逐字模块 |
i18n — 多语言(en_US、ru_RU) | Swagger — 自动生成的 API 文档 |
| Vite HMR — 即时开发重载 | UUID v7 — 时间可排序的主键 | Biome + ESLint — 代码检查与格式化 |
| Helmet + 速率限制 — 内置安全 | CORS — 可配置的源 | 验证 — 自定义装饰器、DTO 守卫 |
| Node / Bun / Deno — 多运行时 | OpenAPI MCP — AI 助手调用你的 API |
一个典型的 CQRS 流程——命令、处理器和服务通过 NestJS 依赖注入进行装配:
…flowchart LR
A[Request] --> B[Guard]
B --> C[Controller]
C --> D[Command / Query Bus]
D --> E[Handler]
E --> F[Service]
F --> G[Repository]
G --> H[(PostgreSQL)]每个功能模块都遵循以下结构:
…将 .env.example 复制为 .env。大多数变量已预配置了可用的默认值。你只需要修改以下这些:
| 变量 | 需要设置的内容 |
|---|---|
DB_HOST、DB_PORT、DB_USERNAME、`DB_PASSWO |
暂无开放 Issues,或尚未同步最近议题。