# mikoyzskie/sgc-app architecture

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

- Interactive diagram: https://gitdiagram.com/mikoyzskie/sgc-app
- Repository: https://github.com/mikoyzskie/sgc-app

## Overview

##### Main Components

A. Client-Side Components:
- Browser/User Interface
- Client-side Runtime (Next.js Client)
- Static Assets (in /public directory)

B. Server-Side Components:
- Next.js Server Runtime
- App Router (new Next.js 13+ architecture)
- Server Components
- Static Generation Pipeline

C. Build-time Components:
- Next.js Build System
- Asset Optimization Pipeline
- TypeScript Compilation Layer

D. Development Tools:
- ESLint Configuration
- Tailwind CSS Processing
- Husky Git Hooks

**Rectangle: Core components**
**Hexagon: Build processes**
**Rounded Rectangle: Runtime environments**

**Blue: Client-side components**
**Green: Server-side components**
**Orange: Build-time processes**
**Grey: External services/tools**

##### Key Relationships to Highlight

A. Request Flow:
- Browser → Next.js Server → Server Components → Client Components
- Static Asset Delivery Path
- API Routes (if added later)

B. Build-time Flow:
- Source Files → Next.js Build → Optimized Output
- TypeScript Compilation
- CSS/Tailwind Processing

##### Important Architectural Elements

A. App Router Structure:
- Root Layout (src/app/layout.tsx)
- Page Components (src/app/page.tsx)
- Global Styles (src/app/globals.css)

B. Static Optimization:
- Font Optimization (next/font)
- Asset Optimization
- Static Generation Paths

##### Deployment Architecture
- Vercel Platform Integration
- Edge Network Distribution
- Build Output Optimization

##### Specific Implementation Details

**Top Layer: Client Interface**

**Middle Layer: Next.js Runtime (Server + Client)**

**Bottom Layer: Build & Optimization Systems**

Specific elements:
- CircleCI Integration (.circleci/config.yml)
- TypeScript Configuration (tsconfig.json)
- Tailwind CSS Processing Pipeline
- Next.js Configuration (next.config.ts)

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Browser/User Interface"]
        ClientRuntime["Next.js Client Runtime"]
        StaticAssets[("Static Assets")]:::assets
    end

    subgraph "Next.js Server Layer"
        ServerRuntime["Next.js Server Runtime"]
        AppRouter["App Router"]:::router
        ServerComponents["Server Components"]
        RootLayout["Root Layout"]:::component
        PageComponent["Page Component"]:::component
        GlobalStyles["Global Styles"]:::styles
    end

    subgraph "Build System"
        BuildSystem{{"Next.js Build System"}}
        TypeScript{{"TypeScript Compilation"}}
        TailwindCSS{{"Tailwind CSS Processing"}}
        PostCSS{{"PostCSS Processing"}}
        AssetOptimization{{"Asset Optimization"}}
    end

    subgraph "Development Tools"
        ESLint["ESLint"]:::tool
        Husky["Git Hooks"]:::tool
        CircleCI["CircleCI Pipeline"]:::tool
    end

    subgraph "Configuration"
        NextConfig["Next.js Config"]:::config
        TSConfig["TypeScript Config"]:::config
        TailwindConfig["Tailwind Config"]:::config
        ESLintConfig["ESLint Config"]:::config
    end

    %% Relationships
    Browser --> ServerRuntime
    ServerRuntime --> ClientRuntime
    ServerRuntime --> StaticAssets
    ServerRuntime --> AppRouter
    AppRouter --> ServerComponents
    ServerComponents --> RootLayout
    ServerComponents --> PageComponent
    ServerComponents --> GlobalStyles

    BuildSystem --> AssetOptimization
    BuildSystem --> TypeScript
    BuildSystem --> TailwindCSS
    TailwindCSS --> PostCSS

    %% Configuration relationships
    NextConfig -.-> BuildSystem
    TSConfig -.-> TypeScript
    TailwindConfig -.-> TailwindCSS
    ESLintConfig -.-> ESLint

    %% Development flow
    CircleCI -.-> BuildSystem
    Husky -.-> BuildSystem
    ESLint -.-> BuildSystem

    %% Styling
    classDef component fill:#a8dadc,stroke:#457b9d
    classDef router fill:#e63946,stroke:#1d3557
    classDef config fill:#f1faee,stroke:#1d3557
    classDef tool fill:#457b9d,stroke:#1d3557
    classDef assets fill:#ffd60a,stroke:#003049
    classDef styles fill:#fb8500,stroke:#023047

    %% Click events
    click StaticAssets "https://github.com/Mikoyzskie/sgc-app/tree/main/public"
    click PageComponent "https://github.com/Mikoyzskie/sgc-app/blob/main/src/app/page.tsx"
    click RootLayout "https://github.com/Mikoyzskie/sgc-app/blob/main/src/app/layout.tsx"
    click GlobalStyles "https://github.com/Mikoyzskie/sgc-app/blob/main/src/app/globals.css"
    click NextConfig "https://github.com/Mikoyzskie/sgc-app/blob/main/next.config.ts"
    click TSConfig "https://github.com/Mikoyzskie/sgc-app/blob/main/tsconfig.json"
    click TailwindConfig "https://github.com/Mikoyzskie/sgc-app/blob/main/tailwind.config.ts"
    click ESLintConfig "https://github.com/Mikoyzskie/sgc-app/blob/main/eslint.config.mjs"
    click CircleCI "https://github.com/Mikoyzskie/sgc-app/blob/main/.circleci/config.yml"
    click Husky "https://github.com/Mikoyzskie/sgc-app/tree/main/.husky/pre-commit"
    click PostCSS "https://github.com/Mikoyzskie/sgc-app/blob/main/postcss.config.mjs"
    click AppRouter "https://github.com/Mikoyzskie/sgc-app/tree/main/src/app"
```
