# dynamitegus/dynamitegus.website architecture

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

- Interactive diagram: https://gitdiagram.com/dynamitegus/dynamitegus.website
- Repository: https://github.com/dynamitegus/dynamitegus.website

## Overview

##### Main System Components

a) Static Site Generation Layer
- Compilation process from source to static output

b) Content Structure
- Content sources (src/content/blog/*.md)
- Pages (src/pages/*)
- Components (src/components/*)
- Layouts (src/layouts/*)

c) Asset Pipeline
- Static assets (public/)
- Styles (src/styles/)
- Scripts (src/scripts/)

**┌─ Build Time ─────────────────────────────────┐  ┌─ Runtime ──────┐**

- ┌─ Source ─────────┐    ┌─ Compilation ─┐  │  │  ┌─ Output ─┐  │
- MD Content     │    │               │  │  │  │           │  │
- Astro Pages   │ -> │    Astro      │  │  │  │  Static   │  │
- Components    │    │    Build      │ -│->│  │  HTML     │  │
- Layouts       │    │    Process    │  │  │  │  CSS      │  │
- ┘    └───────────────┘  │  │  │  JS       │  │

- ┘  │  └───────────┘  │
- ┘

##### Important Relationships to Highlight

- BaseLayout.astro's relationship with other components
- Content collection configuration (src/content/config.ts)
- Style processing pipeline (Tailwind + global styles)
- Component inheritance and composition

##### Technical Details

Specific implementations:
- RSS feed generation process
- Dynamic route generation
- Component hydration points (if any)
- Static asset handling

##### Deployment Flow

A section showing:
- Build output structure
- Static hosting deployment
- Asset optimization

Remember to:
- Use consistent symbols and notation
- Annotations for complex flows
- Both build-time and runtime processes

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Build["Build Time Process"]
        subgraph Source["Source Files"]
            Config["Configuration Files"]
            Content["Content Files"]
            Pages["Page Components"]
            Comps["UI Components"]
            Layouts["Layout Templates"]
            Assets["Static Assets"]
        end

        subgraph Compilation["Compilation Process"]
            Astro["Astro Build System"]
            TailwindCSS["Tailwind CSS Processing"]
            RSS["RSS Generation"]
            Routes["Route Generation"]
        end

        Source --> Compilation
    end

    subgraph Runtime["Runtime"]
        StaticOutput["Static Site Output"]
    end

    Compilation --> StaticOutput

    %% Configuration Details
    Config --> |"Config Files"| Astro
    click Config "https://github.com/dynamitegus/dynamitegus.website/blob/master/astro.config.mjs"

    %% Content Structure
    Content --> |"Blog Posts"| Astro
    click Content "https://github.com/dynamitegus/dynamitegus.website/tree/master/src/content/blog"
    
    %% Layouts
    Layouts --> |"Templates"| Astro
    click Layouts "https://github.com/dynamitegus/dynamitegus.website/blob/master/src/layouts/BaseLayout.astro"

    %% Components
    Comps --> |"UI Elements"| Astro
    click Comps "https://github.com/dynamitegus/dynamitegus.website/tree/master/src/components"

    %% Pages
    Pages --> |"Route Templates"| Astro
    click Pages "https://github.com/dynamitegus/dynamitegus.website/tree/master/src/pages"

    %% Assets
    Assets --> |"Static Files"| Astro
    click Assets "https://github.com/dynamitegus/dynamitegus.website/tree/master/public"

    %% Special Features
    TagSystem["Tag System"] --> Routes
    click TagSystem "https://github.com/dynamitegus/dynamitegus.website/tree/master/src/pages/tags"
    
    ThemeSwitch["Theme Switcher"] --> Comps
    click ThemeSwitch "https://github.com/dynamitegus/dynamitegus.website/blob/master/src/components/ThemeIcon.astro"
    
    RSSFeed["RSS Feed"] --> RSS
    click RSSFeed "https://github.com/dynamitegus/dynamitegus.website/blob/master/src/pages/rss.xml.js"

    %% Interactive Components
    MenuSystem["Menu System"] --> Comps
    click MenuSystem "https://github.com/dynamitegus/dynamitegus.website/blob/master/src/components/Hamburger.astro"
    
    Greeting["Greeting Component"] --> Comps
    click Greeting "https://github.com/dynamitegus/dynamitegus.website/blob/master/src/components/Greeting.jsx"
    
    Social["Social Links"] --> Comps
    click Social "https://github.com/dynamitegus/dynamitegus.website/blob/master/src/components/Social.astro"

    %% Styles
    Styles["Global Styles"] --> TailwindCSS
    click Styles "https://github.com/dynamitegus/dynamitegus.website/blob/master/src/styles/global.css"

    classDef source fill:#e1f5fe,stroke:#01579b
    classDef process fill:#fff3e0,stroke:#ff6f00
    classDef output fill:#e8f5e9,stroke:#2e7d32
    classDef feature fill:#f3e5f5,stroke:#7b1fa2
    
    class Source,Content,Pages,Comps,Layouts,Assets source
    class Compilation,Astro,TailwindCSS,RSS,Routes process
    class StaticOutput output
    class TagSystem,ThemeSwitch,RSSFeed,MenuSystem,Greeting,Social feature
```
