rock-n-prog / apollo-monorepo-poc

POC for a Web-TS monorepo using a Apollo Federation API

Apollo Monorepo POC

Example monorepo to use Apollo Federation in a Turborepo codebase.

See the docs, for list of features, guides, explanations.

Made with love by Fabien Roy.

Status

Name	Type	Status
General	General
Web	App
API Gateway	Service
Contents Service	Service
Reviews Service	Service
Contents Database	Package
Reviews Database	Package
Theme	Package
Web UI	Package
Web Forms	Package
Web Locales	Package
Web Storage	Package

Apps

• apps/web: Next.js web app

Services

• services/api-gateway: GraphQL Apollo gateway for producing supergraph
• services/reviews: GraphQL Apollo server for reviews service
• services/contents: GraphQL Apollo server for reviews service

Packages

• packages/theme: Theme definition
• packages/db/contents: Prisma client and models definitions for contents data
• packages/db/reviews: Prisma client and models definitions for reviews data
• packages/web/ui: React components for web app
• packages/web/forms: React form-specific components for forms app
• packages/web/locales: Locale translations for web app
• packages/web/storage: Storage utilities for web app
• packages/config/eslint/: Shared eslint config
• packages/confgi/stylelint: Shared stylelint config
• packages/config/tsconfig: Shared tsconfig

Setup

Install dependencies

pnpm install

Prepare pre-commit hook

pnpm prepare

Setup database

# Copy env file
pnpm env:local

# Run databases
docker compose up

# Generate Prisma client
pnpm db:generate

# Apply migrations
pnpm db:migrate:dev

# If wanted, generate example data
pnpm db:seed

Setup web GraphQL types and hooks

Be sure that services and API Gateway are running first!

pnpm web:generate

Available scripts

Run apps

pnpm dev

# Running a single app and its deps
pnpm dev:web
pnpm dev:mobile

Run services / API Gateway

pnpm dev

pnpm dev:services

# Run after services
pnpm dev:api

Run storybook

Web UI Library

Storybook will be running on http://localhost:6006;

pnpm storybook:web

Mobile UI Library

Storybook will be running on Expo Go.

pnpm storybook:mobile

Build all

pnpm build

Lint all

pnpm lint

# To fix lint
pnpm lint:fix

# For file names
pnpm lint:ls

# To only apply to root
pnpm lint:root
pnpm lint:root:fix

# Fix lint on staged files
pnpm lint:staged

Format

pnpm format

# To fix format
pnpm format:fix

Cleanup files

pnpm yeet