# manzdev/pixelconga architecture

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

- Interactive diagram: https://gitdiagram.com/manzdev/pixelconga
- Repository: https://github.com/manzdev/pixelconga

## Overview

##### Project type and purpose
- This is a front-end, browser-based interactive application (built with Vite) that renders “PixelConga” characters on a web page (likely as a streaming overlay or chat-driven animation).
- No backend code is present; it’s purely client-side JavaScript, CSS, and static assets.

##### File structure
Top-level:
- public/ – static assets (fonts, images, logo)
- src/ – application source
– components/ – two UI components: PixelcongaPool and PixelcongaChar
– modules/ – helper code (loaderCss.js)
– index.html, index.js, index.css – entry point and global CSS
- vite.config.js – build/development server config
- package.json, pnpm-lock.yaml – dependencies and scripts
Patterns:
- Modular JS components, each with its own CSS
- A loader module for dynamic CSS injection
- Vite as bundler/dev server

##### README
- The README confirms the app listens to some user/chat input, manages characters, and renders them with CSS/DOM animations.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Runtime
    Browser["Client Browser"]:::external

    %% Build & Dev Layer
    subgraph "Build & Development"
        Vite["Vite Dev Server / Bundler"]:::build
    end

    %% Static Assets Layer
    StaticAssets["Static Assets (public/)"]:::assets

    %% Code Layer
    subgraph "Source Code (src)"
        EntryHTML["index.html"]:::entry
        EntryJS["index.js"]:::entry
        EntryCSS["index.css"]:::entry

        loaderCss["loaderCss.js"]:::util

        subgraph "UI Components"
            Pool["PixelcongaPool"]:::ui
            PoolCSS["PixelcongaPool.css"]:::ui
            Char["PixelcongaChar"]:::ui
            CharCSS["PixelcongaChar.css"]:::ui
        end

        InMemoryStore["Hash Table / State Store"]:::util
    end

    %% External Service
    ExternalChat["External Chat/Input Service"]:::external

    %% Connections
    Browser -->|requests| Vite
    Vite -->|serves| EntryHTML
    Browser -->|loads| EntryHTML
    EntryHTML -->|includes| EntryJS
    EntryHTML -->|includes| EntryCSS
    EntryJS -->|imports| loaderCss
    EntryJS -->|imports| Pool
    loaderCss -->|injects CSS| PoolCSS
    loaderCss -->|injects CSS| CharCSS
    ExternalChat -->|events| Pool
    Pool -->|manages| InMemoryStore
    Pool -->|creates/destroys| Char
    Char -->|renders/updates DOM| Browser
    Browser -->|requests assets| StaticAssets

    %% Click Events
    click Vite "https://github.com/manzdev/pixelconga/blob/main/vite.config.js"
    click StaticAssets "https://github.com/manzdev/pixelconga/tree/main/public/"
    click EntryHTML "https://github.com/manzdev/pixelconga/blob/main/src/index.html"
    click EntryJS "https://github.com/manzdev/pixelconga/blob/main/src/index.js"
    click EntryCSS "https://github.com/manzdev/pixelconga/blob/main/src/index.css"
    click loaderCss "https://github.com/manzdev/pixelconga/blob/main/src/modules/loaderCss.js"
    click Pool "https://github.com/manzdev/pixelconga/blob/main/src/components/PixelcongaPool.js"
    click PoolCSS "https://github.com/manzdev/pixelconga/blob/main/src/components/PixelcongaPool.css"
    click Char "https://github.com/manzdev/pixelconga/blob/main/src/components/PixelcongaChar.js"
    click CharCSS "https://github.com/manzdev/pixelconga/blob/main/src/components/PixelcongaChar.css"

    %% Styles
    classDef build fill:#CCE5FF,stroke:#3399FF
    classDef assets fill:#E6E6E6,stroke:#888888
    classDef entry fill:#DFFFE6,stroke:#33CC66
    classDef util fill:#FFF4CC,stroke:#FFCC33
    classDef ui fill:#E6E6FF,stroke:#9966CC
    classDef external fill:#F2F2F2,stroke:#AAAAAA
```
