# teds-tech-talks/n8n-community-leaderboard architecture

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

- Interactive diagram: https://gitdiagram.com/teds-tech-talks/n8n-community-leaderboard
- Repository: https://github.com/teds-tech-talks/n8n-community-leaderboard

## Overview

##### Main Components

A. Static Site Generator Layer
- Jekyll (Primary static site generator)
- Layout templates (_layouts directory)
- Components (_includes directory)
- Markdown content files (*.md)

B. Data Layer
- JSON Data Sources
- stats_aggregate_creators.json
- stats_aggregate_workflows.json

C. Frontend Components
- JavaScript Modules
- generate-table-creators.js
- generate-table-workflows.js
- Styling
- SCSS/CSS components

D. Build & Deployment
- GitHub Pages (implied by _config.yml)

- [Data Sources] → [Jekyll Build Process] → [Generated Static Site] → [Client Browser]

##### Detailed Component Relationships

**JSON Data Files ──→ JavaScript Generators**
- ↓
**Jekyll Layout ────→ Page Templates**
- ↓                  ↓
- Includes         Markdown Content
- ↓                  ↓
- Generated Static Site
- ↓
- Client Browser View

##### Key Elements to Highlight

- Data Flow:
- How JSON data is processed by JavaScript
- How templates incorporate dynamic content
- Demonstrate the build process flow

- Component Integration:
- Jekyll's template inheritance
- Asset pipeline for CSS/JS
- Data transformation process

##### Specific Implementation Details

Use these symbols and notations:
- 📄 For JSON data files
- ⚙️ For build processes
- 🖥️ For frontend components
- 📱 For client-side rendering

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Data
        JSON1["Creators Data"]:::data
        JSON2["Workflows Data"]:::data
    end

    subgraph "Static Site Generator"
        Jekyll["Jekyll Build Process"]:::build
        Config["Configuration"]:::config
        Gemfile["Dependencies"]:::config
    end

    subgraph "Templates & Includes"
        Layout["Layout Templates"]:::template
        Includes["Include Components"]:::template
        Head["Head Custom"]:::template
        Footer["Footer"]:::template
    end

    subgraph "Frontend Assets"
        JS1["Creators Table Generator"]:::frontend
        JS2["Workflows Table Generator"]:::frontend
        CSS["Main Stylesheet"]:::frontend
    end

    subgraph "Content Pages"
        Home["Homepage"]:::content
        About["About Page"]:::content
        N8N["N8N Page"]:::content
        Ratings["Workflow Ratings"]:::content
    end

    subgraph "Output"
        Static["Generated Static Site"]:::output
        Browser["Client Browser"]:::output
    end

    JSON1 --> JS1
    JSON2 --> JS2
    JS1 & JS2 --> Layout
    CSS --> Layout
    Layout --> Static
    Includes --> Layout
    Head & Footer --> Includes
    Config --> Jekyll
    Gemfile --> Jekyll
    Jekyll --> Static
    Home & About & N8N & Ratings --> Jekyll
    Static --> Browser

    %% Click Events
    click Config "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//_config.yml"
    click Layout "https://github.com/teds-tech-talks/n8n-community-leaderboard/tree/main//_layouts"
    click Includes "https://github.com/teds-tech-talks/n8n-community-leaderboard/tree/main//_includes"
    click Head "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//_includes/head-custom.html"
    click Footer "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//_includes/footer.html"
    click JSON1 "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//stats_aggregate_creators.json"
    click JSON2 "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//stats_aggregate_workflows.json"
    click JS1 "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//assets/js/generate-table-creators.js"
    click JS2 "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//assets/js/generate-table-workflows.js"
    click CSS "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//assets/css/style.scss"
    click Home "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//index.md"
    click About "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//about.md"
    click N8N "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//n8n.md"
    click Ratings "https://github.com/teds-tech-talks/n8n-community-leaderboard/blob/main//workflow-ratings.md"
    click Gemfile "https://github.com/teds-tech-talks/n8n-community-leaderboard/tree/main//Gemfile"

    %% Styles
    classDef data fill:#a8d1f0,stroke:#333
    classDef build fill:#90ee90,stroke:#333
    classDef config fill:#d3d3d3,stroke:#333
    classDef template fill:#ffd700,stroke:#333
    classDef frontend fill:#ffa07a,stroke:#333
    classDef content fill:#dda0dd,stroke:#333
    classDef output fill:#98fb98,stroke:#333

    %% Legend
    subgraph Legend
        L1["Data Sources"]:::data
        L2["Build Process"]:::build
        L3["Configuration"]:::config
        L4["Templates"]:::template
        L5["Frontend Assets"]:::frontend
        L6["Content"]:::content
        L7["Output"]:::output
    end
```
