# sabarish-codes/fullstack-monorepo-starter architecture

> Architecture diagram of the GitHub repository sabarish-codes/fullstack-monorepo-starter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sabarish-codes/fullstack-monorepo-starter
- Repository: https://github.com/sabarish-codes/fullstack-monorepo-starter

## Overview

This repository is a reusable full-stack starter: a React frontend and Express API provide the user-facing application and operational endpoints, backed by PostgreSQL and Redis, with separately deployable proxy and monitoring services. The demonstrated API workflow is request routing to check/health/docs/metrics endpoints; the README identifies the frontend, backend, and monitoring as independently deployed. Source excerpts establish application wiring and selected runtime calls; infrastructure and some product capabilities are represented from README descriptions, so their links are documented rather than source-verified.

Main entry points: [`apps/api/src/app.ts`](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/app.ts) (Express app), [`apps/web/src/main.tsx`](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/main.tsx) (React app), [`apps/api/server.ts`](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/server.ts) (API server), [`apps/api/src/routes/health.ts`](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/health.ts) (Health endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web frontend"]
  node_web["React app<br/>[main.tsx]"]
  node_router["Web router<br/>[router.tsx]"]
  node_web_errors["Error boundary<br/>[ErrorBoundary.tsx]"]
  node_query["Query client<br/>[queryClient.ts]"]
end

subgraph group_api["API runtime"]
  node_api_server["API server<br/>[server.ts]"]
  node_app["Express app<br/>[app.ts]"]
  node_check["Check endpoint<br/>[check.ts]"]
  node_health["Health endpoint<br/>[health.ts]"]
  node_docs["API docs<br/>[docs.ts]"]
  node_metrics_route["Metrics endpoint<br/>[metrics.ts]"]
  node_error_handler["Error handling<br/>[errorHandler.ts]"]
  node_openapi["OpenAPI spec<br/>[openapi.ts]"]
end

subgraph group_state["Data services"]
  node_db_client["Database client<br/>[db.ts]"]
  node_schema["Data schema<br/>[schema.ts]"]
  node_postgres[("PostgreSQL")]
  node_redis_client["Redis client<br/>[redis.ts]"]
  node_redis[("Redis")]
end

subgraph group_operations["Operations"]
  node_nginx["Nginx proxy<br/>[nginx.conf]"]
  node_prometheus["Prometheus<br/>[prometheus.yml]"]
  node_grafana["Grafana<br/>[datasource.yml]"]
end

node_visitor(("User"))

node_visitor -.->|"uses"| node_web
node_web -->|"renders"| node_router
node_web -->|"wraps"| node_web_errors
node_web -->|"provides"| node_query
node_api_server -->|"creates"| node_app
node_api_server -->|"checks connection"| node_db_client
node_api_server -->|"connects"| node_redis_client
node_app -->|"mounts"| node_check
node_app -->|"mounts"| node_health
node_app -->|"mounts"| node_metrics_route
node_app -->|"mounts"| node_docs
node_app -->|"handles errors"| node_error_handler
node_health -->|"checks"| node_db_client
node_health -->|"checks"| node_redis_client
node_metrics_route -.->|"exports metrics"| node_prometheus
node_docs -->|"serves"| node_openapi
node_db_client -.->|"connects"| node_postgres
node_redis_client -->|"connects"| node_redis
node_schema -.->|"defines data for"| node_postgres
node_nginx -.->|"proxies requests"| node_api_server
node_prometheus -.->|"supplies metrics"| node_grafana

click node_web "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/main.tsx"
click node_router "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/router.tsx"
click node_web_errors "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/components/ErrorBoundary.tsx"
click node_query "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/lib/queryClient.ts"
click node_api_server "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/server.ts"
click node_app "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/app.ts"
click node_check "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/check.ts"
click node_health "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/health.ts"
click node_docs "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/docs.ts"
click node_metrics_route "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/metrics.ts"
click node_error_handler "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/middleware/errorHandler.ts"
click node_db_client "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/config/db.ts"
click node_schema "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/db/schema.ts"
click node_redis_client "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/config/redis.ts"
click node_nginx "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/nginx/nginx.conf"
click node_prometheus "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/monitoring/prometheus/prometheus.yml"
click node_grafana "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/monitoring/production/grafana/provisioning/datasources/datasource.yml"
click node_openapi "https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/docs/openapi.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_router,node_web_errors,node_query,node_visitor toneBlue
class node_api_server,node_app,node_check,node_health,node_docs,node_metrics_route,node_error_handler,node_openapi toneAmber
class node_db_client,node_schema,node_postgres,node_redis_client,node_redis toneMint
class node_nginx,node_prometheus,node_grafana toneRose
```

## Components

### Web frontend

- [React app](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/main.tsx): `apps/web/src/main.tsx`
- [Web router](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/router.tsx): `apps/web/src/router.tsx`
- [Error boundary](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/components/ErrorBoundary.tsx): `apps/web/src/components/ErrorBoundary.tsx`
- [Query client](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/web/src/lib/queryClient.ts): `apps/web/src/lib/queryClient.ts`

### API runtime

- [API server](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/server.ts): `apps/api/server.ts`
- [Express app](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Check endpoint](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/check.ts): `apps/api/src/routes/check.ts`
- [Health endpoint](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/health.ts): `apps/api/src/routes/health.ts`
- [API docs](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/docs.ts): `apps/api/src/routes/docs.ts`
- [Metrics endpoint](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/routes/metrics.ts): `apps/api/src/routes/metrics.ts`
- [Error handling](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/middleware/errorHandler.ts): `apps/api/src/middleware/errorHandler.ts`
- [OpenAPI spec](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/docs/openapi.ts): `apps/api/src/docs/openapi.ts`

### Data services

- [Database client](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/config/db.ts): `apps/api/src/config/db.ts`
- [Data schema](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/db/schema.ts): `apps/api/src/db/schema.ts`
- **PostgreSQL**
- [Redis client](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/apps/api/src/config/redis.ts): `apps/api/src/config/redis.ts`
- **Redis**

### Operations

- [Nginx proxy](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/nginx/nginx.conf): `nginx/nginx.conf`
- [Prometheus](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/monitoring/prometheus/prometheus.yml): `monitoring/prometheus/prometheus.yml`
- [Grafana](https://github.com/sabarish-codes/fullstack-monorepo-starter/blob/main/monitoring/production/grafana/provisioning/datasources/datasource.yml): `monitoring/production/grafana/provisioning/datasources/datasource.yml`

### Other components

- **User**

## Connections

- User → React app: uses (evidence: `README.md`)
- React app → Web router: renders (evidence: `apps/web/src/main.tsx`)
- React app → Error boundary: wraps (evidence: `apps/web/src/main.tsx`)
- React app → Query client: provides (evidence: `apps/web/src/main.tsx`)
- API server → Express app: creates (evidence: `apps/api/server.ts`)
- API server → Database client: checks connection (evidence: `apps/api/server.ts`)
- API server → Redis client: connects (evidence: `apps/api/server.ts`)
- Express app → Check endpoint: mounts (evidence: `apps/api/src/app.ts`)
- Express app → Health endpoint: mounts (evidence: `apps/api/src/app.ts`)
- Express app → Metrics endpoint: mounts (evidence: `apps/api/src/app.ts`)
- Express app → API docs: mounts (evidence: `apps/api/src/app.ts`)
- Express app → Error handling: handles errors (evidence: `apps/api/src/app.ts`)
- Health endpoint → Database client: checks (evidence: `apps/api/src/routes/health.ts`)
- Health endpoint → Redis client: checks (evidence: `apps/api/src/routes/health.ts`)
- Metrics endpoint → Prometheus: exports metrics (evidence: `README.md`)
- API docs → OpenAPI spec: serves (evidence: `apps/api/src/routes/docs.ts`)
- Database client → PostgreSQL: connects (evidence: `README.md`)
- Redis client → Redis: connects (evidence: `apps/api/src/config/redis.ts`)
- Data schema → PostgreSQL: defines data for (evidence: `README.md`)
- Nginx proxy → API server: proxies requests (evidence: `README.md`)
- Prometheus → Grafana: supplies metrics (evidence: `README.md`)
