# pyloid/pyloid architecture

> Architecture diagram of the GitHub repository pyloid/pyloid, 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/pyloid/pyloid
- Repository: https://github.com/pyloid/pyloid

## Overview

##### Main Components

a) Core Application Layer:
- Main Pyloid class (src/pyloid/pyloid.py) as the central component
- QtWebEngine and PySide6 integration as fundamental building blocks

b) Window Management System:
- BrowserWindow component (src/pyloid/browser_window.py)
- Monitor handling (src/pyloid/monitor.py)
- Custom window features (src/pyloid/custom/titlebar.py)

c) Bridge System:
- JavaScript API layer (src/pyloid/js_api/)
- Event API
- Window API
- Python-JavaScript communication channels

d) System Integration:
- System tray functionality (src/pyloid/tray.py)
- File watching system (src/pyloid/filewatcher.py)
- Auto-start capabilities (src/pyloid/autostart.py)

e) Build System:
- Builder component (src/pyloid/builder/)
- Build configuration handling (build_config.json)

##### Relationship Flows

- Data flow between Python backend and JavaScript frontend
- Event propagation through the event API
- Window management control flow
- System tray interactions
- File system monitoring paths

##### Technical Details

- QtWebEngine integration
- PySide6 component usage
- Python-JavaScript bridge mechanisms
- Event loop management
- Thread pool architecture

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Legend
        L1[Core Components]:::core
        L2[UI Components]:::ui
        L3[Bridge/API]:::bridge
        L4[System Integration]:::system
        L5[Build System]:::build
    end

    subgraph "Core Application Layer"
        PyloidMain["Pyloid Main"]:::core
        QtEngine["Qt WebEngine"]:::core
        PySide["PySide6"]:::core
        APIIntegration["API Integration"]:::core
    end

    subgraph "Window Management"
        BrowserWindow["Browser Window"]:::ui
        MonitorHandler["Monitor Handler"]:::ui
        CustomTitlebar["Custom Titlebar"]:::ui
    end

    subgraph "Bridge System"
        JSBridge["JavaScript Bridge"]:::bridge
        EventAPI["Event API"]:::bridge
        WindowAPI["Window API"]:::bridge
    end

    subgraph "System Integration"
        SystemTray["System Tray"]:::system
        FileWatcher["File Watcher"]:::system
        AutoStart["Auto Start"]:::system
    end

    subgraph "Build System"
        Builder["Builder"]:::build
        BuildSpec["Build Specification"]:::build
        BuildConfig["Build Configuration"]:::build
        BuildSchema["Build Schema"]:::build
    end

    subgraph "Utilities"
        ThreadPool["Thread Pool"]:::core
        Timer["Timer Utility"]:::core
        Utils["General Utilities"]:::core
    end

    PyloidMain --> QtEngine
    PyloidMain --> PySide
    PyloidMain --> APIIntegration
    PyloidMain --> BrowserWindow
    BrowserWindow --> MonitorHandler
    BrowserWindow --> CustomTitlebar
    APIIntegration --> JSBridge
    JSBridge --> EventAPI
    JSBridge --> WindowAPI
    PyloidMain --> SystemTray
    PyloidMain --> FileWatcher
    PyloidMain --> AutoStart
    PyloidMain --> ThreadPool
    ThreadPool --> Timer
    ThreadPool --> Utils
    Builder --> BuildSpec
    Builder --> BuildConfig
    BuildConfig --> BuildSchema

    %% Click events for component mapping
    click PyloidMain "https://github.com/pyloid/pyloid/blob/main/src/pyloid/pyloid.py"
    click APIIntegration "https://github.com/pyloid/pyloid/blob/main/src/pyloid/api.py"
    click BrowserWindow "https://github.com/pyloid/pyloid/blob/main/src/pyloid/browser_window.py"
    click MonitorHandler "https://github.com/pyloid/pyloid/blob/main/src/pyloid/monitor.py"
    click CustomTitlebar "https://github.com/pyloid/pyloid/blob/main/src/pyloid/custom/titlebar.py"
    click EventAPI "https://github.com/pyloid/pyloid/blob/main/src/pyloid/js_api/event_api.py"
    click WindowAPI "https://github.com/pyloid/pyloid/blob/main/src/pyloid/js_api/window_api.py"
    click SystemTray "https://github.com/pyloid/pyloid/blob/main/src/pyloid/tray.py"
    click FileWatcher "https://github.com/pyloid/pyloid/blob/main/src/pyloid/filewatcher.py"
    click AutoStart "https://github.com/pyloid/pyloid/blob/main/src/pyloid/autostart.py"
    click Builder "https://github.com/pyloid/pyloid/blob/main/src/pyloid/builder/__init__.py"
    click BuildSpec "https://github.com/pyloid/pyloid/blob/main/src/pyloid/builder/spec.py"
    click BuildConfig "https://github.com/pyloid/pyloid/blob/main/build_config.json"
    click BuildSchema "https://github.com/pyloid/pyloid/blob/main/src/pyloid/builder/build_config.schema.json"
    click ThreadPool "https://github.com/pyloid/pyloid/blob/main/src/pyloid/thread_pool.py"
    click Timer "https://github.com/pyloid/pyloid/blob/main/src/pyloid/timer.py"
    click Utils "https://github.com/pyloid/pyloid/blob/main/src/pyloid/utils.py"

    classDef core fill:#3498db,stroke:#2980b9,color:white
    classDef ui fill:#2ecc71,stroke:#27ae60,color:white
    classDef bridge fill:#e67e22,stroke:#d35400,color:white
    classDef system fill:#9b59b6,stroke:#8e44ad,color:white
    classDef build fill:#95a5a6,stroke:#7f8c8d,color:white
```
