# 0noxtackore/fluxckore architecture

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

- Interactive diagram: https://gitdiagram.com/0noxtackore/fluxckore
- Repository: https://github.com/0noxtackore/fluxckore

## Overview

Fluxckore is a Windows desktop maintenance suite: a user opens its WebView interface, monitors system status, selects cleanup categories, and starts maintenance. The GUI delegates elevated cleanup to a hidden worker, which reports progress through a shared log. Other documented capabilities include memory optimization, registry maintenance, language selection, and startup diagnostics. The README and excerpts establish the product workflow; some app orchestration details and feature implementations are only partially sampled, so uncertain links are omitted.

Main entry points: [`fluxckore/app.py`](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/app.py) (Desktop app and API), [`fluxckore/__main__.py`](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/__main__.py) (Application launcher), [`fluxckore/core/headless.py`](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/headless.py) (Elevated cleanup worker), [`fluxckore/i18n.py`](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/i18n.py) (Translation manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch and UI"]
  node_launcher["Application launcher<br/>[__main__.py]"]
  node_app["Desktop app and API<br/>[app.py]"]
  node_frontend["Web interface<br/>[index.html]"]
end

subgraph group_maintenance["Maintenance"]
  node_worker["Elevated cleanup worker<br/>[headless.py]"]
  node_cleanup["Selected cleanup<br/>[maintenance.py]"]
  node_memory["Memory optimization<br/>[maintenance.py]"]
  node_registry["Registry maintenance<br/>[maintenance.py]"]
end

subgraph group_system["System services"]
  node_monitor["System monitoring<br/>[monitoring.py]"]
  node_settings[("User settings<br/>[system.py]")]
  node_profile[("WebView profile<br/>[browser_profile.py]")]
  node_instance["Single-instance guard<br/>[single_instance.py]"]
  node_startup["Startup diagnostics<br/>[startup_log.py]"]
  node_unblock["Download-mark removal<br/>[unblock.py]"]
  node_sounds["Notification sounds<br/>[sounds.py]"]
end

subgraph group_language["Localization"]
  node_translations["Translation manager<br/>[i18n.py]"]
  node_locale_data["Translation data<br/>[translations.json]"]
end

node_user(("Windows user"))

node_user -->|"launches"| node_launcher
node_launcher -->|"removes zone marks"| node_unblock
node_launcher -->|"starts"| node_app
node_launcher -->|"logs startup"| node_startup
node_app -->|"loads interface"| node_frontend
node_user -->|"uses"| node_app
node_app -->|"requests system stats"| node_monitor
node_app -->|"reads and updates"| node_settings
node_app -->|"configures WebView"| node_profile
node_app -->|"enforces one instance"| node_instance
node_app -->|"records launch phases"| node_startup
node_app -->|"plays notifications"| node_sounds
node_app -->|"selects language"| node_translations
node_app -->|"starts elevated run"| node_worker
node_worker -->|"cleans selected categories"| node_cleanup
node_worker -->|"optimizes memory"| node_memory
node_worker -.->|"runs registry cleanup"| node_registry
node_translations -->|"loads translations"| node_locale_data

click node_launcher "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/__main__.py"
click node_app "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/app.py"
click node_frontend "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/frontend/index.html"
click node_monitor "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/monitoring.py"
click node_settings "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/system.py"
click node_profile "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/browser_profile.py"
click node_instance "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/single_instance.py"
click node_startup "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/startup_log.py"
click node_unblock "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/unblock.py"
click node_sounds "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/sounds.py"
click node_worker "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/headless.py"
click node_cleanup "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/maintenance.py"
click node_memory "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/maintenance.py"
click node_registry "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/maintenance.py"
click node_translations "https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/i18n.py"
click node_locale_data "https://github.com/0noxtackore/fluxckore/blob/main/locales/translations.json"

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_launcher,node_app,node_frontend,node_user toneBlue
class node_worker,node_cleanup,node_memory,node_registry toneAmber
class node_monitor,node_settings,node_profile,node_instance,node_startup,node_unblock,node_sounds toneMint
class node_translations,node_locale_data toneRose
```

## Components

### Launch and UI

- [Application launcher](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/__main__.py): `fluxckore/__main__.py`
- [Desktop app and API](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/app.py): `fluxckore/app.py`
- [Web interface](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/frontend/index.html): `fluxckore/frontend/index.html`

### Maintenance

- [Elevated cleanup worker](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/headless.py): `fluxckore/core/headless.py`
- [Selected cleanup](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/maintenance.py): `fluxckore/core/maintenance.py`
- [Memory optimization](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/maintenance.py): `fluxckore/core/maintenance.py`
- [Registry maintenance](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/maintenance.py): `fluxckore/core/maintenance.py`

### System services

- [System monitoring](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/monitoring.py): `fluxckore/core/monitoring.py`
- [User settings](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/system.py): `fluxckore/core/system.py`
- [WebView profile](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/browser_profile.py): `fluxckore/core/browser_profile.py`
- [Single-instance guard](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/single_instance.py): `fluxckore/core/single_instance.py`
- [Startup diagnostics](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/startup_log.py): `fluxckore/core/startup_log.py`
- [Download-mark removal](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/unblock.py): `fluxckore/core/unblock.py`
- [Notification sounds](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/core/sounds.py): `fluxckore/core/sounds.py`

### Localization

- [Translation manager](https://github.com/0noxtackore/fluxckore/blob/main/fluxckore/i18n.py): `fluxckore/i18n.py`
- [Translation data](https://github.com/0noxtackore/fluxckore/blob/main/locales/translations.json): `locales/translations.json`

### Other components

- **Windows user**

## Connections

- Windows user → Application launcher: launches (evidence: `README.md`)
- Application launcher → Download-mark removal: removes zone marks (evidence: `fluxckore/__main__.py`)
- Application launcher → Desktop app and API: starts (evidence: `fluxckore/__main__.py`)
- Application launcher → Startup diagnostics: logs startup (evidence: `fluxckore/__main__.py`)
- Desktop app and API → Web interface: loads interface (evidence: `fluxckore/app.py`)
- Windows user → Desktop app and API: uses (evidence: `README.md`)
- Desktop app and API → System monitoring: requests system stats (evidence: `fluxckore/app.py`)
- Desktop app and API → User settings: reads and updates (evidence: `fluxckore/app.py`)
- Desktop app and API → WebView profile: configures WebView (evidence: `fluxckore/app.py`)
- Desktop app and API → Single-instance guard: enforces one instance (evidence: `fluxckore/app.py`)
- Desktop app and API → Startup diagnostics: records launch phases (evidence: `fluxckore/app.py`)
- Desktop app and API → Notification sounds: plays notifications (evidence: `fluxckore/app.py`)
- Desktop app and API → Translation manager: selects language (evidence: `fluxckore/app.py`)
- Desktop app and API → Elevated cleanup worker: starts elevated run (evidence: `README.md`)
- Elevated cleanup worker → Selected cleanup: cleans selected categories (evidence: `fluxckore/core/headless.py`)
- Elevated cleanup worker → Memory optimization: optimizes memory (evidence: `fluxckore/core/headless.py`)
- Elevated cleanup worker → Registry maintenance: runs registry cleanup (evidence: `fluxckore/core/headless.py`)
- Translation manager → Translation data: loads translations (evidence: `fluxckore/i18n.py`)