# up2dul/site architecture

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

- Interactive diagram: https://gitdiagram.com/up2dul/site
- Repository: https://github.com/up2dul/site

## Overview

##### Main System Components

a) Static Site Generation Layer
- Astro.js as the core framework
- Content Collection System
- Build System

b) Frontend Components Layer
- Layout Components
- Common Components
- Content Components

c) Content Management Layer
- Markdown Content
- RSS Feed Generation
- SEO Management

##### Specific Elements

**[GitHub Actions] → [Build Process]**
- ↓
**[Astro Framework]**
- ↙     ↓     ↘
**[Components] [Content] [Styles]**
- ↓         ↓         ↓
**[Layout]   [Markdown]  [Tailwind]**
**[Common]   [RSS Feed]**
**[Pages]    [SEO]**

##### Important Relationships to Highlight

- How the content collection system interfaces with markdown files
- Relationship between layouts and pages
- Demonstrate the build process flow from source to static output
- How the RSS feed generator interfaces with content

##### Technical Details

- Astro's component architecture
- Content collection typing system
- Build optimization process
- SEO implementation strategy

- Component relationships
- Build flow direction
- Content processing pipeline
- Integration points between systems

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Build
        GH[GitHub Actions]
        BP[Build Process]
        SO[Static Output]
    end

    subgraph Framework
        AC["Astro Config"]
        CCS["Content Collection System"]
        AF["Astro Framework"]
    end

    subgraph Components
        direction TB
        LC["Layout Components"]
        CC["Common Components"]
        CP["Content Pages"]
    end

    subgraph Content
        direction TB
        MD["Markdown Content"]
        RSS["RSS Feed"]
        SEO["SEO Management"]
    end

    subgraph Styling
        direction TB
        TW["Tailwind CSS"]
        CSS["Main CSS"]
    end

    %% Build Flow
    GH --> BP
    BP --> SO

    %% Framework Connections
    AF --> LC
    AF --> CC
    AF --> CP
    AF --> CCS

    %% Content Management
    CCS --> MD
    MD --> CP
    CP --> RSS
    CP --> SEO

    %% Styling
    TW --> CSS
    CSS --> LC
    CSS --> CC

    %% Component Details
    LC --> |"Includes"|BL["Base Layout"]
    LC --> |"Includes"|CL["Content Layout"]
    LC --> |"Includes"|HD["Header"]
    LC --> |"Includes"|FT["Footer"]

    CC --> |"Includes"|CD["Content Card"]
    CC --> |"Includes"|TB["Theme Button"]
    CC --> |"Includes"|NL["Navigation Link"]

    CP --> |"Contains"|HP["Home Page"]
    CP --> |"Contains"|WP["Writings Page"]
    CP --> |"Contains"|DC["Dynamic Content"]

    %% Styling
    classDef build fill:#FFA500,stroke:#fff
    classDef framework fill:#4169E1,stroke:#fff
    classDef component fill:#800080,stroke:#fff
    classDef content fill:#228B22,stroke:#fff
    classDef styling fill:#808080,stroke:#fff

    class GH,BP,SO build
    class AF,AC,CCS framework
    class LC,CC,CP,BL,CL,HD,FT,CD,TB,NL,HP,WP,DC component
    class MD,RSS,SEO content
    class TW,CSS styling

    %% Click Events
    click AC "https://github.com/up2dul/site/blob/main/astro.config.ts"
    click CCS "https://github.com/up2dul/site/blob/main/src/content/config.ts"
    click GH "https://github.com/up2dul/site/blob/main/.github/workflows/deploy.yaml"
    click LC "https://github.com/up2dul/site/tree/main/src/components/layout/"
    click BL "https://github.com/up2dul/site/blob/main/src/components/layout/BaseLayout.astro"
    click CL "https://github.com/up2dul/site/blob/main/src/components/layout/ContentLayout.astro"
    click HD "https://github.com/up2dul/site/blob/main/src/components/layout/Header.astro"
    click FT "https://github.com/up2dul/site/blob/main/src/components/layout/Footer.astro"
    click CC "https://github.com/up2dul/site/tree/main/src/components/common/"
    click CD "https://github.com/up2dul/site/blob/main/src/components/common/ContentCard.astro"
    click TB "https://github.com/up2dul/site/blob/main/src/components/common/ThemeButton.astro"
    click NL "https://github.com/up2dul/site/blob/main/src/components/common/Link.astro"
    click CP "https://github.com/up2dul/site/tree/main/src/pages/"
    click HP "https://github.com/up2dul/site/blob/main/src/pages/index.astro"
    click WP "https://github.com/up2dul/site/blob/main/src/pages/writings.astro"
    click DC "https://github.com/up2dul/site/blob/main/src/pages/writings/[...slug].astro"
    click MD "https://github.com/up2dul/site/tree/main/src/content/writings/"
    click RSS "https://github.com/up2dul/site/blob/main/src/pages/rss.xml.ts"
    click SEO "https://github.com/up2dul/site/blob/main/src/components/SEO.astro"
    click CSS "https://github.com/up2dul/site/blob/main/src/index.css"
    click TW "https://github.com/up2dul/site/blob/main/tailwind.config.ts"
```
