# alex-md/jsreact architecture

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

- Interactive diagram: https://gitdiagram.com/alex-md/jsreact
- Repository: https://github.com/alex-md/jsreact

## Overview

##### Main System Components

a) Frontend Layer (UI Components)
- Navbar (navigation and dark mode)
- Header
- Footer
- Toast (notifications)
- Individual tool pages (clean, diff, expression, etc.)

b) Application Layer (Tools)
- Text Cleaner
- Diff Checker
- Expression Solver
- AI Name Generator
- Keyword Analyzer
- Code Minifier

c) Core Services Layer
- Shared services:
- Common Utilities (common.js)
- Theme Management
- Error Handling

##### Technical Stack Representation

A stack section showing:
- Frontend Framework (React-like UI)
- CSS Framework (Tailwind)
- Build Tools (Webpack)
- Development Tools (Hot Reloading)

**┌─────────────────────────────────────────┐**
- UI Layer (Components)        │
- ┤
- Application Layer (Tools)       │
- ┤
- Core Services Layer          │
- ┤
- Technical Stack              │
- ┘

##### Notes for Implementation

- Modular architecture of tools
- Shared component reuse
- Common utilities integration
- Build and optimization process
- Development workflow

This approach creates a comprehensive yet clear visualization of the project's architecture while maintaining the appropriate level of detail for a principal software engineer to understand the system's structure and relationships.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef tool fill:#2ecc71,stroke:#27ae60,color:white
    classDef service fill:#f1c40f,stroke:#f39c12,color:black
    classDef tech fill:#9b59b6,stroke:#8e44ad,color:white
    classDef asset fill:#e74c3c,stroke:#c0392b,color:white

    %% UI Layer
    subgraph UI
        Navbar["Navbar"]:::ui
        Header["Header"]:::ui
        Footer["Footer"]:::ui
        Toast["Toast"]:::ui
        Head["Head"]:::ui
    end

    %% Tool Pages Layer
    subgraph Pages
        Clean["Text Cleaner Page"]:::ui
        Diff["Diff Checker Page"]:::ui
        Expr["Expression Solver Page"]:::ui
        Gen["AI Name Generator Page"]:::ui
        Key["Keyword Analyzer Page"]:::ui
        Min["Code Minifier Page"]:::ui
    end

    %% Tool Implementation Layer
    subgraph Tools
        CleanTool["Text Cleaner"]:::tool
        DiffTool["Diff Checker"]:::tool
        ExprTool["Expression Solver"]:::tool
        GenTool["AI Name Generator"]:::tool
        KeyTool["Keyword Analyzer"]:::tool
        MinTool["Code Minifier"]:::tool
    end

    %% Core Services Layer
    subgraph Core
        Common["Common Utilities"]:::service
        GlobalCSS["Global Styles"]:::service
        MainCSS["Main Styles"]:::service
    end

    %% Build & Config Layer
    subgraph Config
        TailwindConfig["Tailwind Config"]:::tech
        DeployFlow["Deployment Workflow"]:::tech
    end

    %% Static Assets
    subgraph Assets
        Images["Images"]:::asset
        SEO["SEO Files"]:::asset
        SiteConfig["Site Configuration"]:::asset
    end

    %% Relationships
    Clean --> CleanTool
    Diff --> DiffTool
    Expr --> ExprTool
    Gen --> GenTool
    Key --> KeyTool
    Min --> MinTool

    Common --> CleanTool
    Common --> DiffTool
    Common --> ExprTool
    Common --> GenTool
    Common --> KeyTool
    Common --> MinTool

    GlobalCSS --> UI
    MainCSS --> UI
    TailwindConfig --> GlobalCSS

    %% Click Events
    click Navbar "https://github.com/alex-md/jsreact/blob/rollback/src/components/navbar.js"
    click Header "https://github.com/alex-md/jsreact/blob/rollback/src/components/header.js"
    click Footer "https://github.com/alex-md/jsreact/blob/rollback/src/components/footer.js"
    click Toast "https://github.com/alex-md/jsreact/blob/rollback/src/components/toast.js"
    click Head "https://github.com/alex-md/jsreact/blob/rollback/src/components/head.js"
    
    click Clean "https://github.com/alex-md/jsreact/blob/rollback/src/clean.html"
    click Diff "https://github.com/alex-md/jsreact/blob/rollback/src/diff.html"
    click Expr "https://github.com/alex-md/jsreact/blob/rollback/src/expression.html"
    click Gen "https://github.com/alex-md/jsreact/blob/rollback/src/generator.html"
    click Key "https://github.com/alex-md/jsreact/blob/rollback/src/keyword.html"
    click Min "https://github.com/alex-md/jsreact/blob/rollback/src/minify.html"
    
    click CleanTool "https://github.com/alex-md/jsreact/blob/rollback/src/scripts/clean.js"
    click DiffTool "https://github.com/alex-md/jsreact/blob/rollback/src/scripts/diff.js"
    click ExprTool "https://github.com/alex-md/jsreact/blob/rollback/src/scripts/expression.js"
    click GenTool "https://github.com/alex-md/jsreact/blob/rollback/src/scripts/generator.js"
    click KeyTool "https://github.com/alex-md/jsreact/blob/rollback/src/scripts/keyword.js"
    click MinTool "https://github.com/alex-md/jsreact/blob/rollback/src/scripts/minify.js"
    
    click Common "https://github.com/alex-md/jsreact/blob/rollback/src/scripts/common.js"
    click GlobalCSS "https://github.com/alex-md/jsreact/blob/rollback/src/styles/global.css"
    click MainCSS "https://github.com/alex-md/jsreact/blob/rollback/src/styles/main.css"
    
    click TailwindConfig "https://github.com/alex-md/jsreact/blob/rollback/tailwind.config.js"
    click DeployFlow "https://github.com/alex-md/jsreact/blob/rollback/.github/workflows/main.yml"
    
    click Images "https://github.com/alex-md/jsreact/tree/rollback/src/images"
    click SiteConfig "https://github.com/alex-md/jsreact/tree/rollback/src/_headers"
    click SEO "https://github.com/alex-md/jsreact/blob/rollback/src/robots.txt"
```
