以类型安全为目标的 nodejs 全栈 monorepo 模版

站长

2024年04月12日 19:58 · 阅读数 7

这是以类型安全为目标的全栈 monorepo 模版，采用 GraphQL 作为数据交换层，并通过 @graphql-codegen/cli 将编写的查询 gql 生成前端请求 Hook 代码。

数据库访问由 ORM prisma 驱动，通过 pothos 构建 code-first GraphQL schema，结合 pothos prisma 插件实现类型从数据库模型映射到 GraphQL，再映射到前端查询 Hook，保证了整个链路类型的安全。

预览

此模版包含用户登录并查询 User 表的最小 DEMO 代码

以类型安全为目标的 nodejs 全栈 monorepo 模版

项目结构

apps/client: 客户端根目录
apps/server: 服务端根目录
packages/eslint-config-custom: ESLint 基础配置
packages/tsconfig: TypeScript 配置，包含服务端、React 应用、React Library 配置

主要技术栈

客户端

React + Vite + @tanstack/react-query + @vanilla-extract/css

服务端

@apollo/server - GraphQL 服务器，底层基于 Express
pothos - 构建 code-first GraphQL schema
prisma - ORM
pino - 日志打印库

仓库

turbo - monorepo 构建系统
pnpm - 包管理器

开始

安装依赖

pnpm i

配置服务端环境变量

新建 apps/server/.env 文件，输入以下内容

SERVER_PORT=4010
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/prisma-gql?schema=public

# 通过 docker compose 启动时需要配置
PG_USER=postgres
PG_PASSWORD=postgres

以上数据库信息可以根据自身情况进行配置

准备服务端依赖服务

如果没有 postgres 服务，可以单独启动或者使用 docker compose 启动

# 单独启动
docker run --name postgres -p 5432:5432 -e POSTGRES_PASSWORD=postgres -d postgres

# 使用 docker compose
cd apps/server
docker compose up -d

创建数据库并生成访问代码

cd apps/server
pnpm prisma db push

# 初始化用户
pnpm tsx ./scripts/seed.ts

启动服务

# 仓库根目录下
pnpm dev