# negiseijin/monorepo architecture

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

- Interactive diagram: https://gitdiagram.com/negiseijin/monorepo
- Repository: https://github.com/negiseijin/monorepo

## Overview

##### Project type and purpose
- This is a full-stack TypeScript monorepo using Turborepo. It contains:
- A Vite-based React frontend (apps/client)
- A Hono-based Node backend (apps/server)
- A Prisma-driven database package (packages/database)
- A shared schema/types package (packages/schema)
- A shared TypeScript config package (packages/typescript-config)
- Its purpose is to serve a single-page application that consumes REST endpoints to manage authors, books, comments, and users, persisting data in a SQL database.

##### File structure
- Top-level: workspace configs (pnpm, turbo.json, tsconfig, docker-compose, nginx.conf).
- apps/client: React app, builds to static assets, uses shared TS config, PostCSS/Tailwind.
- apps/server: Hono server, defines REST routes, imports the schema & database packages.
- packages/database: Prisma schema, migrations, seed script, exports a DB client.
- packages/schema: exports TypeScript types/models (User, Post).
- packages/typescript-config: shared tsconfig base for uniform typing across all projects.

##### README
- Confirms the tech stack (React, Hono, TypeScript, Turborepo).
- Mentions developer workflows (pnpm dev, pnpm build).

##### Main components of the system
a. Client frontend (apps/client)
b. Reverse proxy / load balancer (nginx container)
c. Backend API server (apps/server)
d. Shared packages (schema, typescript-config)
e. Database service (PostgreSQL via Docker + Prisma migrations)
f. Developer host (local machine invoking Docker Compose)

##### Relationships and interactions
- Browser → Nginx (HTTP/HTTPS)
- Nginx → Hono server (proxying client and API requests)
- Server → Database client (Prisma ORM)
- Database client → PostgreSQL container (SQL queries)
- Server & Client both import types from packages/schema and tsconfig from typescript-config
- Docker Compose orchestrates containers (nginx, server, client [optional], db)

##### Architectural patterns and design principles
- Monorepo with shared code (DRY principle)
- Layered architecture: Presentation (React) → API layer (Hono) → Domain/Model (schema) → Data Access (Prisma) → Persistence (PostgreSQL)
- Containerized services (Docker Compose) for isolation and parity across environments
- CI/CD ready—build and dev scripts managed by Turborepo tasks

##### Relevant technologies/frameworks/libraries
- Frontend: React, Vite, Tailwind CSS, TypeScript
- Backend: Hono framework, Node.js, TypeScript
- Database: PostgreSQL, Prisma ORM, SQL migrations
- Monorepo: Turborepo, pnpm workspaces
- Dev Tools: Biome (lint/format), Husky (pre-commit hooks), Docker, nginx

##### Elements
- Browser → nginx → React SPA assets
- Browser → nginx → Hono API
- Hono API → Prisma Client → PostgreSQL
- Client/Server → shared schema/types module
- Green for frontend components
- Blue for backend components
- Orange for database layer
- Gray for shared libraries/config

##### Detailed capturing of essential elements
- Prisma’s migration folder driving the DB schema on startup.
- Volumes or bind mounts for initdb.d (create-schema.sql) to highlight schema initialization.
- Nginx.conf file mapping / to client and /api to server.

- Monorepo structure and shared packages
- Separation of concerns between client, API, and database
- Container orchestration and reverse-proxy routing
- Data flow from the browser down to SQL storage

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External developer host
    DeveloperHost["Developer Host"]:::external
    DeveloperHost -->|uses| DockerCompose

    subgraph "Container Orchestration" 
        direction TB
        DockerCompose["Docker Compose"]:::orchestration
        DockerCompose -->|orchestrates| NginxProxy
        DockerCompose -->|orchestrates| HonoAPI
        DockerCompose -->|orchestrates| PostgreSQLDB
    end

    %% Presentation Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["Browser"]:::external
        Browser -->|HTTP/HTTPS| NginxProxy
        NginxProxy["nginx Proxy"]:::proxy
        NginxProxy -->|serves assets| ReactSPA
        ReactSPA["React SPA"]:::frontend
        ReactSPA -->|imports types| SchemaTypes
        ReactSPA -->|imports config| TSConfig
    end

    %% API Layer
    subgraph "Backend Layer"
        direction TB
        NginxProxy -->|proxies API| HonoAPI
        HonoAPI["Hono API"]:::backend
        HonoAPI -->|imports types| SchemaTypes
        HonoAPI -->|imports config| TSConfig
        HonoAPI -->|uses| PrismaClient
    end

    %% Data Access Layer
    subgraph "Database Layer"
        direction TB
        PrismaClient["Prisma Client"]:::database
        PrismaClient -->|SQL queries| PostgreSQLDB
        PostgreSQLDB["PostgreSQL DB"]:::database
        DBInitScripts["DB Init Scripts"]:::database
        DBInitScripts -->|initializes schema| PostgreSQLDB
    end

    %% Shared Modules
    subgraph "Shared Modules"
        direction TB
        SchemaTypes["Schema/Types"]:::shared
        TSConfig["TS Config"]:::shared
    end

    %% Click Events
    click ReactSPA "https://github.com/negiseijin/monorepo/tree/main/apps/client/"
    click NginxProxy "https://github.com/negiseijin/monorepo/blob/main/nginx.conf"
    click HonoAPI "https://github.com/negiseijin/monorepo/blob/main/apps/server/src/index.ts"
    click PrismaClient "https://github.com/negiseijin/monorepo/blob/main/packages/database/src/index.ts"
    click SchemaTypes "https://github.com/negiseijin/monorepo/blob/main/packages/schema/src/index.ts"
    click TSConfig "https://github.com/negiseijin/monorepo/blob/main/packages/typescript-config/base.json"
    click DBInitScripts "https://github.com/negiseijin/monorepo/blob/main/initdb.d/create-schema.sql"
    click DockerCompose "https://github.com/negiseijin/monorepo/blob/main/docker-compose.yml"

    %% Styles
    classDef frontend fill:#d0f8ce,stroke:#2e7d32,stroke-width:2px;
    classDef backend fill:#bbdefb,stroke:#1565c0,stroke-width:2px;
    classDef database fill:#ffe0b2,stroke:#ef6c00,stroke-width:2px;
    classDef shared fill:#e0e0e0,stroke:#424242,stroke-width:2px;
    classDef proxy fill:#c5cae9,stroke:#283593,stroke-width:2px,stroke-dasharray: 5 5;
    classDef orchestration fill:#f3e5f5,stroke:#6a1b9a,stroke-width:2px,stroke-dasharray: 5 5;
    classDef external fill:#ffffff,stroke:#000000,stroke-width:1px;
```
