# amirkarimi/browser-hub architecture

> Architecture diagram of the GitHub repository amirkarimi/browser-hub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amirkarimi/browser-hub
- Repository: https://github.com/amirkarimi/browser-hub

## Overview

##### Main Components

a) Input Layer:
- External URL Sources (e.g., VSCode, Terminal, System Links)
- Browser Hub CLI Interface

b) Core Components:
- URL Router/Dispatcher (main.py)
- Configuration Manager (config.py)
- Process Manager (processes.py)

c) Output Layer:
- Browser Profile Instances
- URL Transformers

**[External Sources] → [Browser Hub Core] → [Browser Instances]**

##### Specific Implementation Details

Crucial components:
- Config File (.config/browser-hub/config.json)
- Profile Definitions
- URL Pattern Matching System
- Process Management System
- URL Transformation Pipeline

##### Key Processes to Illustrate

a) URL Processing Pipeline:
**URL Input → Pattern Matching → Profile Selection → URL Transformation → Browser Launch**

b) Process Management:
**Active Browser Detection → Profile Identification → Instance Selection**

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef input fill:#90EE90,stroke:#333,stroke-width:2px
    classDef core fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef config fill:#DDA0DD,stroke:#333,stroke-width:2px
    classDef browser fill:#FFA500,stroke:#333,stroke-width:2px
    classDef process fill:#FFB6C1,stroke:#333,stroke-width:2px

    %% Input Layer
    subgraph InputSources
        VS["VSCode"]:::input
        Term["Terminal"]:::input
        Sys["System Links"]:::input
    end

    %% Core Components
    subgraph CoreProcessing
        CLI["Browser Hub CLI"]:::core
        Router["URL Router/Dispatcher"]:::core
        ConfigMgr["Configuration Manager"]:::core
        ProcMgr["Process Manager"]:::core
        URLTrans["URL Transformer"]:::core
    end

    %% Configuration
    subgraph Configuration
        Config["Config File\n(.config/browser-hub/config.json)"]:::config
        Profiles["Profile Definitions"]:::config
        URLPatterns["URL Patterns"]:::config
    end

    %% Browser Instances
    subgraph BrowserInstances
        Profile1["Browser Profile 1"]:::browser
        Profile2["Browser Profile 2"]:::browser
        Profile3["Browser Profile 3"]:::browser
    end

    %% Relationships
    VS --> CLI
    Term --> CLI
    Sys --> CLI
    CLI --> Router
    Router --> URLTrans
    Router --> ConfigMgr
    ConfigMgr --> Config
    Config --> Profiles
    Config --> URLPatterns
    ProcMgr --> Profile1
    ProcMgr --> Profile2
    ProcMgr --> Profile3
    URLTrans --> Profile1
    URLTrans --> Profile2
    URLTrans --> Profile3
    Router --> ProcMgr

    %% Click Events
    click Router "https://github.com/amirkarimi/browser-hub/blob/main/src/browser_hub/main.py"
    click ConfigMgr "https://github.com/amirkarimi/browser-hub/blob/main/src/browser_hub/config.py"
    click ProcMgr "https://github.com/amirkarimi/browser-hub/blob/main/src/browser_hub/processes.py"

    %% Legend
    subgraph Legend
        L1["Input Sources"]:::input
        L2["Core Components"]:::core
        L3["Configuration"]:::config
        L4["Browser Instances"]:::browser
        L5["Process Management"]:::process
    end
```
