# binobinos/quilix architecture

> Architecture diagram of the GitHub repository binobinos/quilix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/binobinos/quilix
- Repository: https://github.com/binobinos/quilix

## Overview

Quilix is a PyQt6 desktop web browser. The main workflow is launching the Qt application, opening and navigating web tabs, and retaining browsing state and preferences. The graph preserves documented browsing, theme, session, and productivity capabilities. Source excerpts confirm the main window’s responsibilities and some tab behavior; unsampled implementation details are represented only where README documentation supports them.

Main entry points: [`core/modern_browser.py`](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py) (Browser window), [`core/browser_tab.py`](https://github.com/binobinos/quilix/blob/main/core/browser_tab.py) (Browser tab), [`core/main.py`](https://github.com/binobinos/quilix/blob/main/core/main.py) (Qt launcher), [`core/config/config.py`](https://github.com/binobinos/quilix/blob/main/core/config/config.py) (Runtime config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Browser runtime"]
  node_entry["Qt launcher<br/>[main.py]"]
  node_config["Runtime config<br/>[config.py]"]
  node_window["Browser window<br/>[modern_browser.py]"]
  node_utilities["File and CSS utilities<br/>[util.py]"]
end

subgraph group_browsing["Browsing experience"]
  node_tabs["Tab manager<br/>[modern_browser.py]"]
  node_tab["Browser tab<br/>[browser_tab.py]"]
  node_web["Web content<br/>[browser_tab.py]"]
  node_navigation["Navigation and search<br/>[modern_browser.py]"]
  node_home["Home page<br/>[main.html]"]
  node_notes["Tab notes<br/>[browser_tab.py]"]
  node_downloads["Downloads<br/>[modern_browser.py]"]
  node_productivity["Pomodoro timer<br/>[modern_browser.py]"]
end

subgraph group_state_ui["State and interface"]
  node_session["Session restore<br/>[modern_browser.py]"]
  node_preferences["Browser preferences<br/>[modern_browser.py]"]
  node_history["Browsing history<br/>[modern_browser.py]"]
  node_bookmarks["Bookmarks<br/>[modern_browser.py]"]
  node_themes["Theme styling"]
end

node_user(("Browser user"))
node_websites(("Websites"))

node_user -->|"launches"| node_entry
node_entry -->|"loads flags"| node_config
node_entry -->|"creates window"| node_window
node_user -->|"uses browser"| node_window
node_window -->|"manages tabs"| node_tabs
node_tabs -->|"creates tabs"| node_tab
node_tab -->|"hosts view"| node_web
node_web -.->|"loads pages"| node_websites
node_window -->|"routes input"| node_navigation
node_navigation -->|"opens URL"| node_tabs
node_tab -->|"loads default page"| node_home
node_window -->|"restores and saves"| node_session
node_window -->|"reads settings"| node_preferences
node_window -->|"searches history"| node_history
node_navigation -->|"matches entries"| node_history
node_window -->|"searches bookmarks"| node_bookmarks
node_tab -->|"provides notes area"| node_notes
node_window -->|"handles downloads"| node_downloads
node_window -->|"controls timer"| node_productivity
node_window -->|"applies theme"| node_themes
node_window -->|"loads CSS"| node_utilities

click node_entry "https://github.com/binobinos/quilix/blob/main/core/main.py"
click node_config "https://github.com/binobinos/quilix/blob/main/core/config/config.py"
click node_window "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_tabs "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_tab "https://github.com/binobinos/quilix/blob/main/core/browser_tab.py"
click node_web "https://github.com/binobinos/quilix/blob/main/core/browser_tab.py"
click node_navigation "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_home "https://github.com/binobinos/quilix/blob/main/core/home/main.html"
click node_session "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_preferences "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_history "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_bookmarks "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_notes "https://github.com/binobinos/quilix/blob/main/core/browser_tab.py"
click node_downloads "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_productivity "https://github.com/binobinos/quilix/blob/main/core/modern_browser.py"
click node_themes "https://github.com/binobinos/quilix/tree/main/core/styles"
click node_utilities "https://github.com/binobinos/quilix/blob/main/core/util.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_config,node_window,node_utilities,node_user toneBlue
class node_tabs,node_tab,node_web,node_navigation,node_home,node_notes,node_downloads,node_productivity toneAmber
class node_session,node_preferences,node_history,node_bookmarks,node_themes toneMint
class node_websites toneIndigo
```

## Components

### Browser runtime

- [Qt launcher](https://github.com/binobinos/quilix/blob/main/core/main.py): `core/main.py`
- [Runtime config](https://github.com/binobinos/quilix/blob/main/core/config/config.py): `core/config/config.py`
- [Browser window](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [File and CSS utilities](https://github.com/binobinos/quilix/blob/main/core/util.py): `core/util.py`

### Browsing experience

- [Tab manager](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [Browser tab](https://github.com/binobinos/quilix/blob/main/core/browser_tab.py): `core/browser_tab.py`
- [Web content](https://github.com/binobinos/quilix/blob/main/core/browser_tab.py): `core/browser_tab.py`
- [Navigation and search](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [Home page](https://github.com/binobinos/quilix/blob/main/core/home/main.html): `core/home/main.html`
- [Tab notes](https://github.com/binobinos/quilix/blob/main/core/browser_tab.py): `core/browser_tab.py`
- [Downloads](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [Pomodoro timer](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`

### State and interface

- [Session restore](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [Browser preferences](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [Browsing history](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [Bookmarks](https://github.com/binobinos/quilix/blob/main/core/modern_browser.py): `core/modern_browser.py`
- [Theme styling](https://github.com/binobinos/quilix/tree/main/core/styles): `core/styles`

### Other components

- **Browser user**
- **Websites**

## Connections

- Browser user → Qt launcher: launches (evidence: `README.md`)
- Qt launcher → Runtime config: loads flags (evidence: `core/main.py`)
- Qt launcher → Browser window: creates window (evidence: `core/main.py`)
- Browser user → Browser window: uses browser (evidence: `README.md`)
- Browser window → Tab manager: manages tabs (evidence: `core/modern_browser.py`)
- Tab manager → Browser tab: creates tabs (evidence: `core/browser_tab.py`)
- Browser tab → Web content: hosts view (evidence: `core/browser_tab.py`)
- Web content → Websites: loads pages
- Browser window → Navigation and search: routes input (evidence: `core/modern_browser.py`)
- Navigation and search → Tab manager: opens URL (evidence: `core/modern_browser.py`)
- Browser tab → Home page: loads default page (evidence: `core/browser_tab.py`)
- Browser window → Session restore: restores and saves (evidence: `core/modern_browser.py`)
- Browser window → Browser preferences: reads settings (evidence: `core/modern_browser.py`)
- Browser window → Browsing history: searches history (evidence: `core/modern_browser.py`)
- Navigation and search → Browsing history: matches entries (evidence: `core/modern_browser.py`)
- Browser window → Bookmarks: searches bookmarks (evidence: `core/modern_browser.py`)
- Browser tab → Tab notes: provides notes area (evidence: `core/browser_tab.py`)
- Browser window → Downloads: handles downloads (evidence: `core/modern_browser.py`)
- Browser window → Pomodoro timer: controls timer (evidence: `core/modern_browser.py`)
- Browser window → Theme styling: applies theme (evidence: `core/modern_browser.py`)
- Browser window → File and CSS utilities: loads CSS (evidence: `core/modern_browser.py`)
