# matsim-org/website-11ty architecture

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

- Interactive diagram: https://gitdiagram.com/matsim-org/website-11ty
- Repository: https://github.com/matsim-org/website-11ty

## Overview

##### Main Components Identification

The system architecture should highlight these key components:

a) Build System Layer
- Eleventy (11ty) as the static site generator
- Node.js runtime environment
- NPM package management

b) Configuration Layer
- Template languages (CSS, JavaScript configurations)
- Collections, filters, and plugins
- Shortcodes and transforms
- Utility functions

c) Source Content Layer
- Layouts (_layouts)
- Includes (_includes)
- Data (_data)
- Content (markdown files)
- Assets (CSS, JavaScript, images, fonts)

**┌─────────────────────────────────────────────────────────┐**
- Browser/Client Layer                    │
- ┘
- ↑

**┌─────────────────────────────────────────────────────────┐**
- Static HTML Output                      │
- ┘
- ↑

**┌─────────────────────────────────────────────────────────┐**
- Build Process                         │
- ┬─────────────────────────┬─────────────────┤
- Eleventy   │     Node.js/NPM         │    Plugins      │
- ┴─────────────────────────┴─────────────────┘
- ↑

**┌─────────────────────────────────────────────────────────┐**
- Source Components                       │
- ┬──────────┬──────────┬──────────┬────────────┤
- Layouts  │ Includes │   Data   │ Content  │  Assets    │
- ┴──────────┴──────────┴──────────┴────────────┘

##### Important Relationships to Highlight

- How the build process transforms source files into static output
- Configuration flow affecting build process
- Demonstrate asset pipeline (CSS, JS, images)
- Template inheritance patterns
- Data flow from _data directory to templates

##### Additional Notes

- Use clear labels for each component
- Version control integration points
- Build optimization processes

## Diagram (Mermaid)

```mermaid
graph TD
    subgraph "Browser Layer"
        Browser["Browser/Client"]
    end

    subgraph "Static Output"
        StaticHTML["Static HTML Output"]
    end

    subgraph "Build System"
        BuildProcess["Build Process"]
        Eleventy["Eleventy (11ty)"]:::build
        NodeNPM["Node.js/NPM"]:::build
        BuildConfig["Build Configuration"]:::config
    end

    subgraph "Configuration Layer"
        Templates["Template Languages"]:::config
        Collections["Collections"]:::config
        Filters["Filters"]:::config
        Plugins["Plugins"]:::config
        Shortcodes["Shortcodes"]:::config
        Transforms["Transforms"]:::config
        Utils["Utils"]:::config
    end

    subgraph "Source Content"
        Layouts["Layouts"]:::source
        Includes["Includes"]:::source
        Data["Data"]:::source
        Content["Content"]:::source
        
        subgraph "Assets"
            CSS["CSS"]:::asset
            JavaScript["JavaScript"]:::asset
            Images["Images"]:::asset
            Fonts["Fonts"]:::asset
            DesignTokens["Design Tokens"]:::asset
        end

        subgraph "CSS Architecture"
            Blocks["Blocks"]:::css
            Compositions["Compositions"]:::css
            CSSUtils["Utilities"]:::css
            GlobalStyles["Global Styles"]:::css
        end
    end

    Browser --> StaticHTML
    StaticHTML --> BuildProcess
    
    BuildProcess --> Eleventy
    BuildProcess --> NodeNPM
    BuildProcess --> BuildConfig
    
    Eleventy --> Templates
    Eleventy --> Collections
    Eleventy --> Filters
    Eleventy --> Plugins
    Eleventy --> Shortcodes
    Eleventy --> Transforms
    Eleventy --> Utils
    
    Templates --> Layouts
    Templates --> Includes
    Templates --> Content
    
    CSS --> Blocks
    CSS --> Compositions
    CSS --> CSSUtils
    CSS --> GlobalStyles

    classDef build fill:#90EE90
    classDef config fill:#DDA0DD
    classDef source fill:#FFB6C1
    classDef asset fill:#87CEEB
    classDef css fill:#FFA07A

    click BuildConfig "https://github.com/matsim-org/website-11ty/blob/main/.eleventy.js"
    click Templates "https://github.com/matsim-org/website-11ty/tree/main//config/template-languages/"
    click Collections "https://github.com/matsim-org/website-11ty/tree/main//config/collections/"
    click Filters "https://github.com/matsim-org/website-11ty/tree/main//config/filters/"
    click Plugins "https://github.com/matsim-org/website-11ty/tree/main//config/plugins/"
    click Shortcodes "https://github.com/matsim-org/website-11ty/tree/main//config/shortcodes/"
    click Transforms "https://github.com/matsim-org/website-11ty/tree/main//config/transforms/"
    click Utils "https://github.com/matsim-org/website-11ty/tree/main//config/utils/"
    click Layouts "https://github.com/matsim-org/website-11ty/tree/main//src/_layouts/"
    click Includes "https://github.com/matsim-org/website-11ty/tree/main//src/_includes/"
    click Data "https://github.com/matsim-org/website-11ty/tree/main//src/_data/"
    click Content "https://github.com/matsim-org/website-11ty/tree/main//src/content/"
    click CSS "https://github.com/matsim-org/website-11ty/tree/main//src/assets/css/"
    click JavaScript "https://github.com/matsim-org/website-11ty/tree/main//src/assets/scripts/"
    click Images "https://github.com/matsim-org/website-11ty/tree/main//src/assets/images/"
    click Fonts "https://github.com/matsim-org/website-11ty/tree/main//src/assets/fonts/"
    click DesignTokens "https://github.com/matsim-org/website-11ty/tree/main//src/assets/design-tokens/"
    click Blocks "https://github.com/matsim-org/website-11ty/tree/main//src/assets/css/blocks/"
    click Compositions "https://github.com/matsim-org/website-11ty/tree/main//src/assets/css/compositions/"
    click CSSUtils "https://github.com/matsim-org/website-11ty/tree/main//src/assets/css/utilities/"
    click GlobalStyles "https://github.com/matsim-org/website-11ty/tree/main//src/assets/css/global/"
```
