# mahdita97/turborepo-boilerplate architecture

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

- Interactive diagram: https://gitdiagram.com/mahdita97/turborepo-boilerplate
- Repository: https://github.com/mahdita97/turborepo-boilerplate

## Overview

##### Project type and purpose
- This is a frontend-focused monorepo boilerplate using Turborepo.
- It hosts one Next.js “web” application and several shared packages (UI component library, ESLint configs, TypeScript configs, Tailwind config).
- Its purpose is to demonstrate how to structure a multi-package repo for building a consistent design system and web app with shared configs and components.

##### File structure
Top-level
- turbo.json          → Turborepo pipeline definitions (task graph, caching)
- package.json        → root scripts for workspace management
- tsconfig.json       → base TypeScript settings
- .gitignore, README  → repo-wide metadata
apps/web
- Next.js + Tailwind site
- next.config.js uses `transpilePackages` to compile shared UI on build
- src/app contains layout, pages, global CSS
packages/
- ui                 → React component library (TSX + Tailwind)
- config-eslint      → shared ESLint configurations
- config-typescript  → shared tsconfig variants (base, nextjs, react-library)
- tailwind-config    → single Tailwind config consumed by both app + UI

##### Extract architecture notes from the README
- Build “ui” into dist but consume via Next.js compiler
- Share one Tailwind config to avoid class collision
- Leverage Turborepo to orchestrate build/lint/test across all workspaces

##### Main components
a. Turborepo Orchestrator (root)
- Defines task pipelines (build/ui → build/web → test)
- Caches outputs, parallelizes tasks
b. apps/web (Next.js application)
c. packages/ui (shared React + Tailwind component library)
d. Shared config packages
– config-eslint (lint rules)
– config-typescript (TS project references)
– tailwind-config (CSS utility settings)
e. External ecosystems
– npm/Yarn (package registry)
– daisyUI & daisyUI-React (third-party UI plugins)

##### Relationships & interactions
- apps/web imports UI components (packages/ui)
- Both apps/web and packages/ui extend tailwind-config for styling
- Both codebases extend config-eslint and config-typescript via “extends” in their respective config files
- Turborepo triggers:
- build: ui → dist
- build: web (with transpilePackages(ui))
- lint/test across all workspaces

##### Architectural patterns & design principles
- Monorepo pattern with Turborepo for cross-package orchestration
- Shared configuration via dedicated config packages to enforce consistency
- Component library (packages/ui) as single source of truth for UI elements
- Tailwind “content” scanning strategy centralized in tailwind-config

- Component boundaries: root vs. apps vs. packages
- Data/asset flows: build outputs, tailwind CSS generation, transpilation
- External plugin dependencies: daisyUI, npm registry

- Highlights Turborepo’s orchestration role
- Shows how the Next.js app consumes the shared UI library and configs
- Depicts the monorepo’s shared-config strategy and build pipeline
You capture every package as its own component, group related items, and annotate interactions to avoid ambiguity.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Root Monorepo
    subgraph "Root Monorepo"
        direction TB
        Orchestrator(("Turborepo Orchestrator")):::orchestrator
        Root_pkg["package.json"]:::file
        Root_tsconfig["tsconfig.json"]:::file
        Root_turbo["turbo.json"]:::file
    end

    %% Apps
    subgraph "apps/web (Next.js App)" 
        direction TB
        WebApp["apps/web"]:::frontend
        NextConfig["next.config.js"]:::file
        WebPkg["package.json"]:::file
        WebTsconfig["tsconfig.json"]:::file
        WebTailwind["tailwind.config.ts"]:::file
        Layout["layout.tsx"]:::file
        Page["page.tsx"]:::file
        GlobalsCSS["globals.css"]:::file
    end

    %% Packages
    subgraph "packages"
        direction TB
        subgraph "ui (React-TSX)" 
            direction TB
            UIPkgDir["packages/ui"]:::pkg
            UIPkg["package.json"]:::file
            UITsup["tsup.config.ts"]:::file
            UITailwind["tailwind.config.ts"]:::file
            UIIndex["index.tsx"]:::file
            UICard["card.tsx"]:::file
            UIContainer["container.tsx"]:::file
            UINavbar["navbar.tsx"]:::file
            UIHero["hero-login.tsx"]:::file
            UIStyles["styles.css"]:::file
            UIDaisy["daiysiui-react.tsx"]:::file
            UIPostcss["postcss.config.js"]:::file
            UIEslint[".eslintrc.js"]:::file
        end

        subgraph "config-eslint"
            direction TB
            ESLintDir["packages/config-eslint"]:::config
            ESLintPkg["package.json"]:::file
            ESLintrc[".eslintrc.js"]:::file
            ESLintNext["next.js"]:::file
            ESLintLib["library.js"]:::file
        end

        subgraph "config-typescript"
            direction TB
            TsconfigDir["packages/config-typescript"]:::config
            TsPkg["package.json"]:::file
            TSBase["base.json"]:::file
            TSNext["nextjs.json"]:::file
            TSReactLib["react-library.json"]:::file
        end

        subgraph "tailwind-config"
            direction TB
            TWDir["packages/tailwind-config"]:::config
            TWPkg["package.json"]:::file
            TWConfig["tailwind.config.ts"]:::file
            TWTsconfig["tsconfig.json"]:::file
        end
    end

    %% External
    subgraph "External Dependencies"
        direction TB
        Npm["npm/Yarn Registry"]:::external
        Daisy["daisyUI & React Adapter"]:::external
    end

    %% Orchestration Links
    Orchestrator -->|orchestrates| WebApp
    Orchestrator -->|orchestrates| UIPkgDir
    Orchestrator --> ESLintDir
    Orchestrator --> TsconfigDir
    Orchestrator --> TWDir

    %% File flip links
    Orchestrator --> Root_pkg
    Orchestrator --> Root_tsconfig
    Orchestrator --> Root_turbo

    %% App dependencies
    WebApp -->|imports| UIPkgDir
    WebApp -->|extends| ESLintDir
    WebApp -->|extends| TsconfigDir
    WebApp -->|uses config| TWDir

    %% UI dependencies
    UIPkgDir -->|extends| TsconfigDir
    UIPkgDir -->|extends| ESLintDir
    UIPkgDir -->|uses config| TWDir
    UIPkgDir -->|import plugin| Daisy

    %% External
    WebApp -->|publishes/pulls| Npm
    UIPkgDir -->|publishes/pulls| Npm

    %% Click Events
    click Orchestrator "https://github.com/mahdita97/turborepo-boilerplate/blob/main/turbo.json"
    click Root_pkg "https://github.com/mahdita97/turborepo-boilerplate/blob/main/package.json"
    click Root_tsconfig "https://github.com/mahdita97/turborepo-boilerplate/blob/main/tsconfig.json"
    click Root_turbo "https://github.com/mahdita97/turborepo-boilerplate/blob/main/turbo.json"
    click WebApp "https://github.com/mahdita97/turborepo-boilerplate/tree/main/apps/web/"
    click NextConfig "https://github.com/mahdita97/turborepo-boilerplate/blob/main/apps/web/next.config.js"
    click WebPkg "https://github.com/mahdita97/turborepo-boilerplate/blob/main/apps/web/package.json"
    click WebTsconfig "https://github.com/mahdita97/turborepo-boilerplate/blob/main/apps/web/tsconfig.json"
    click WebTailwind "https://github.com/mahdita97/turborepo-boilerplate/blob/main/apps/web/tailwind.config.ts"
    click Layout "https://github.com/mahdita97/turborepo-boilerplate/blob/main/apps/web/src/app/layout.tsx"
    click Page "https://github.com/mahdita97/turborepo-boilerplate/blob/main/apps/web/src/app/page.tsx"
    click GlobalsCSS "https://github.com/mahdita97/turborepo-boilerplate/blob/main/apps/web/src/app/globals.css"
    click UIPkgDir "https://github.com/mahdita97/turborepo-boilerplate/tree/main/packages/ui/"
    click UIPkg "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/package.json"
    click UITsup "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/tsup.config.ts"
    click UITailwind "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/tailwind.config.ts"
    click UIIndex "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/src/index.tsx"
    click UICard "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/src/card.tsx"
    click UIContainer "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/src/container.tsx"
    click UINavbar "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/src/navbar.tsx"
    click UIHero "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/src/hero-login.tsx"
    click UIStyles "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/src/styles.css"
    click UIDaisy "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/src/daiysiui-react.tsx"
    click UIPostcss "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/postcss.config.js"
    click UIEslint "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/ui/.eslintrc.js"
    click ESLintDir "https://github.com/mahdita97/turborepo-boilerplate/tree/main/packages/config-eslint/"
    click ESLintPkg "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-eslint/package.json"
    click ESLintrc "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-eslint/.eslintrc.js"
    click ESLintNext "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-eslint/next.js"
    click ESLintLib "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-eslint/library.js"
    click TsconfigDir "https://github.com/mahdita97/turborepo-boilerplate/tree/main/packages/config-typescript/"
    click TsPkg "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-typescript/package.json"
    click TSBase "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-typescript/base.json"
    click TSNext "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-typescript/nextjs.json"
    click TSReactLib "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/config-typescript/react-library.json"
    click TWDir "https://github.com/mahdita97/turborepo-boilerplate/tree/main/packages/tailwind-config/"
    click TWPkg "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/tailwind-config/package.json"
    click TWConfig "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/tailwind-config/tailwind.config.ts"
    click TWTsconfig "https://github.com/mahdita97/turborepo-boilerplate/blob/main/packages/tailwind-config/tsconfig.json"

    %% Styles
    classDef orchestrator fill:#f9f,stroke:#333,stroke-width:2px
    classDef frontend fill:#bbf,stroke:#333,stroke-width:1px
    classDef pkg fill:#bfb,stroke:#333,stroke-width:1px
    classDef config fill:#fbf,stroke:#333,stroke-width:1px
    classDef external fill:#ffe,stroke:#333,stroke-width:1px
    classDef file fill:#fff,stroke:#999,stroke-width:1px,stroke-dasharray: 2 2
```
