# ou9999-wdl/turborepo-test architecture

> Architecture diagram of the GitHub repository ou9999-wdl/turborepo-test, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ou9999-wdl/turborepo-test
- Repository: https://github.com/ou9999-wdl/turborepo-test

## Overview

##### Project type and purpose
- This is a monorepo template primarily hosting two Next.js front-end applications (“web” and “web-admin”), a shared UI component library (shadcn/ui in `packages/ui`), plus several tooling/configuration packages (`eslint-config`, `typescript-config`) and a small utility library (`packages/util`).
- Purpose: speed up multi-app development by centralizing shared UI components, coding standards, and utilities, all orchestrated by pnpm workspaces and Turborepo.

##### File structure
- Top-level “apps” folder:
- `apps/web` – Next.js app for general users
- `apps/web-admin` – Next.js app for administration
- Top-level “packages” folder:
- `packages/ui` – Shared React/Tailwind UI components
- `packages/util` – Shared helper functions (e.g., date utils)
- `packages/eslint-config` & `packages/typescript-config` – Central linting and TS settings
- Root files: pnpm workspace config (`pnpm-workspace.yaml`), Turborepo config (`turbo.json`), lock file, lint/prettier configs.

##### README for additional insights
- Confirms monorepo is autogenerated by `pnpm dlx shadcn@latest init`
- Emphasizes adding UI components via a CLI into `packages/ui` and automatic Tailwind integration.
- Usage pattern: apps import UI components from `@workspace/ui/components/...`.

##### Detail
- Every local package as its own component rather than lumping “packages” together.
- Root-level config files (tsconfig.json, .eslintrc.js, turbo.json) influencing the entire workspace.
- If desired, annotate that adding new shadcn/ui components happens via CLI and updates `packages/ui`.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Orchestration & Package Management"
        TB["Turborepo"]:::tools
        PN["PNPM Workspace"]:::tools
    end

    subgraph "Global Configs"
        PkgJson["package.json"]:::config
        PnpmY["pnpm-workspace.yaml"]:::config
        TJson["turbo.json"]:::config
        ESLRC[".eslintrc.js"]:::config
        TSC["tsconfig.json"]:::config
    end

    subgraph "Applications"
        Web["Web App"]:::app
        Admin["Admin App"]:::app
    end

    subgraph "Shared Packages"
        UI["UI Library"]:::package
        Util["Util Library"]:::package
        ESLintCfg["ESLint Config"]:::package
        TSCfg["TS Config"]:::package
    end

    %% Orchestration relationships
    TB -->|"orchestrates build"| Web
    TB -->|"orchestrates build"| Admin
    TB -->|"orchestrates build"| UI
    TB -->|"orchestrates build"| Util
    TB -->|"orchestrates build"| ESLintCfg
    TB -->|"orchestrates build"| TSCfg

    PN -->|"manages deps"| Web
    PN -->|"manages deps"| Admin
    PN -->|"manages deps"| UI
    PN -->|"manages deps"| Util
    PN -->|"manages deps"| ESLintCfg
    PN -->|"manages deps"| TSCfg

    %% Config propagation
    PkgJson -->|"scripts"| Web
    PkgJson -->|"scripts"| Admin
    PkgJson -->|"scripts"| UI
    PkgJson -->|"scripts"| Util
    PkgJson -->|"scripts"| ESLintCfg
    PkgJson -->|"scripts"| TSCfg

    PnpmY -->|"workspace setup"| Web
    PnpmY -->|"workspace setup"| Admin
    PnpmY -->|"workspace setup"| UI
    PnpmY -->|"workspace setup"| Util
    PnpmY -->|"workspace setup"| ESLintCfg
    PnpmY -->|"workspace setup"| TSCfg

    TJson -->|"pipeline config"| Web
    TJson -->|"pipeline config"| Admin
    TJson -->|"pipeline config"| UI
    TJson -->|"pipeline config"| Util
    TJson -->|"pipeline config"| ESLintCfg
    TJson -->|"pipeline config"| TSCfg

    ESLRC -->|"lint rules"| Web
    ESLRC -->|"lint rules"| Admin
    ESLRC -->|"lint rules"| UI
    ESLRC -->|"lint rules"| Util
    ESLRC -->|"lint rules"| ESLintCfg
    ESLRC -->|"lint rules"| TSCfg

    TSC -->|"ts settings"| Web
    TSC -->|"ts settings"| Admin
    TSC -->|"ts settings"| UI
    TSC -->|"ts settings"| Util
    TSC -->|"ts settings"| ESLintCfg
    TSC -->|"ts settings"| TSCfg

    %% App dependencies on shared packages
    Web -->|"imports"| UI
    Web -->|"imports"| Util
    Web -->|"uses config"| ESLintCfg
    Web -->|"uses config"| TSCfg

    Admin -->|"imports"| UI
    Admin -->|"imports"| Util
    Admin -->|"uses config"| ESLintCfg
    Admin -->|"uses config"| TSCfg

    %% Click events
    click Web "https://github.com/ou9999-wdl/turborepo-test/tree/main/apps/web"
    click Admin "https://github.com/ou9999-wdl/turborepo-test/tree/main/apps/web-admin"
    click UI "https://github.com/ou9999-wdl/turborepo-test/tree/main/packages/ui"
    click Util "https://github.com/ou9999-wdl/turborepo-test/tree/main/packages/util"
    click ESLintCfg "https://github.com/ou9999-wdl/turborepo-test/tree/main/packages/eslint-config"
    click TSCfg "https://github.com/ou9999-wdl/turborepo-test/tree/main/packages/typescript-config"
    click TJson "https://github.com/ou9999-wdl/turborepo-test/blob/main/turbo.json"
    click PnpmY "https://github.com/ou9999-wdl/turborepo-test/blob/main/pnpm-workspace.yaml"
    click ESLRC "https://github.com/ou9999-wdl/turborepo-test/blob/main/.eslintrc.js"
    click TSC "https://github.com/ou9999-wdl/turborepo-test/blob/main/tsconfig.json"
    click PkgJson "https://github.com/ou9999-wdl/turborepo-test/blob/main/package.json"

    %% Styles
    classDef app fill:#D0E8FF,stroke:#000
    classDef package fill:#D0FFD6,stroke:#000
    classDef tools fill:#EEEEEE,stroke:#000
    classDef config fill:#FFF5CC,stroke:#000
```
