# riggraz/no-style-please architecture

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

- Interactive diagram: https://gitdiagram.com/riggraz/no-style-please
- Repository: https://github.com/riggraz/no-style-please

## Overview

##### Main Components Identification

a. Theme Core Components:
- Layouts System
- Components
- Styling System
- Data Configuration
- Content Management

b. Build & Deployment:
- Jekyll Build Process
- GitHub Pages Integration

- Content Layer       |

- Theme Layer         |

- Build Layer         |

- Deployment Layer    |

##### Component Relationships

a. Content Layer:
- Relationships between `_posts/`, `_data/`, and markdown pages
- With menu configuration (`_data/menu.yml`)

b. Theme Layer:
- How `_layouts/` templates use `_includes/` components
- Demonstrate how `_sass/` connects to the styling pipeline
- Theme configuration flow from `_config.yml`

c. Build Layer:
- Jekyll's build process
- Asset compilation flow
- How the theme gem integrates

d. Deployment Layer:
- GitHub Pages deployment flow
- GitHub Actions workflow

##### Specific Component Details

Key elements:
**Theme Components:**
- Layout System (default.html, post.html, etc.)
- Include Components (head.html, menu_item.html, etc.)
- Style System (no-style-please.scss)
- Configuration (menu.yml, _config.yml)

**Content Management:**
- Posts Directory
- Pages (about.md, archive.md)
- Assets (css, js)

**Build Process:**
- Jekyll Build Pipeline
- Asset Compilation
- SEO Integration
- RSS Feed Generation

##### Important Features to Highlight

Unique aspects:
- Minimal CSS architecture (1kb)
- Light/Dark mode switching system
- Content-first approach
- GitHub Pages compatibility
- Jekyll plugins integration (SEO Tag, Feed)

##### Data Flow Indicators

- Content compilation flow
- Theme asset processing
- Template inheritance
- Build pipeline direction
- Deployment process

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Content
        Posts["Posts Directory"]:::content
        Pages["Static Pages"]:::content
        Data["Data Files"]:::content
    end

    subgraph Theme
        Layouts["Layout System"]:::theme
        Includes["Include Components"]:::theme
        Styling["Styling System"]:::theme
        Config["Configuration"]:::theme

        subgraph "Layout Files"
            Default["Default Layout"]:::theme
            Post["Post Layout"]:::theme
            Page["Page Layout"]:::theme
            Archive["Archive Layout"]:::theme
            Home["Home Layout"]:::theme
        end

        subgraph "Include Files"
            Head["Header Component"]:::theme
            MenuItem["Menu Item Component"]:::theme
            PostList["Post List Component"]:::theme
            BackLink["Navigation Component"]:::theme
            Analytics["Analytics Component"]:::theme
        end

        subgraph "Style Files"
            SCSS["Main SCSS"]:::theme
            MainCSS["Compiled CSS"]:::theme
            CSSOutput["CSS Output"]:::theme
        end

        subgraph "Config Files"
            ThemeConfig["Theme Config"]:::config
            MenuConfig["Menu Config"]:::config
        end
    end

    subgraph Build
        Jekyll["Jekyll Build Process"]:::build
        Assets["Asset Pipeline"]:::build
        Plugins["Jekyll Plugins"]:::build
        GemConfig["Gem Configuration"]:::build
    end

    subgraph Deployment
        GHPages["GitHub Pages"]:::deploy
        GHActions["GitHub Actions"]:::deploy
    end

    %% Relationships
    Posts --> Jekyll
    Pages --> Jekyll
    Data --> Jekyll
    
    Layouts --> Jekyll
    Includes --> Layouts
    Styling --> Assets
    Config --> Jekyll

    Jekyll --> GHPages
    GHActions --> GHPages

    %% Component Mappings
    click Posts "https://github.com/riggraz/no-style-please/tree/master//_posts"
    click Layouts "https://github.com/riggraz/no-style-please/tree/master//_layouts"
    click Default "https://github.com/riggraz/no-style-please/blob/master//_layouts/default.html"
    click Post "https://github.com/riggraz/no-style-please/blob/master//_layouts/post.html"
    click Page "https://github.com/riggraz/no-style-please/blob/master//_layouts/page.html"
    click Archive "https://github.com/riggraz/no-style-please/blob/master//_layouts/archive.html"
    click Home "https://github.com/riggraz/no-style-please/blob/master//_layouts/home.html"
    click Includes "https://github.com/riggraz/no-style-please/tree/master//_includes"
    click Head "https://github.com/riggraz/no-style-please/blob/master//_includes/head.html"
    click MenuItem "https://github.com/riggraz/no-style-please/blob/master//_includes/menu_item.html"
    click PostList "https://github.com/riggraz/no-style-please/blob/master//_includes/post_list.html"
    click BackLink "https://github.com/riggraz/no-style-please/blob/master//_includes/back_link.html"
    click Analytics "https://github.com/riggraz/no-style-please/blob/master//_includes/goat_counter.html"
    click SCSS "https://github.com/riggraz/no-style-please/blob/master//_sass/no-style-please.scss"
    click MainCSS "https://github.com/riggraz/no-style-please/blob/master//assets/css/main.scss"
    click CSSOutput "https://github.com/riggraz/no-style-please/blob/master//assets/css/main.css"
    click ThemeConfig "https://github.com/riggraz/no-style-please/blob/master//_config.yml"
    click MenuConfig "https://github.com/riggraz/no-style-please/blob/master//_data/menu.yml"
    click GHActions "https://github.com/riggraz/no-style-please/blob/master//.github/workflows/jekyll.yml"
    click GemConfig "https://github.com/riggraz/no-style-please/blob/master//no-style-please.gemspec"

    %% Styles
    classDef theme fill:#3498db,stroke:#2980b9,color:white
    classDef content fill:#2ecc71,stroke:#27ae60,color:white
    classDef build fill:#e67e22,stroke:#d35400,color:white
    classDef deploy fill:#9b59b6,stroke:#8e44ad,color:white
    classDef config fill:#f1c40f,stroke:#f39c12,color:black

    %% Legend
    subgraph Legend
        L1["Theme Components"]:::theme
        L2["Content Components"]:::content
        L3["Build Components"]:::build
        L4["Deployment Components"]:::deploy
        L5["Configuration Files"]:::config
    end
```
