# jax-core/jaxcore architecture

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

- Interactive diagram: https://gitdiagram.com/jax-core/jaxcore
- Repository: https://github.com/jax-core/jaxcore

## Overview

JaxCore is a Rainmeter-based Windows desktop configuration hub and a collection of utility modules/widgets. The user-facing flow centers on navigating the Core interface to discover modules or adjust their settings; the repository also provides installation, updates, rollback, support pages, and reusable desktop interactions. The excerpts show the settings UI rendering data-driven controls and the home page switching views. Other subsystems are represented from README claims and the file tree; their internal wiring was not sampled, so no speculative links are drawn.

Main entry points: [`Core`](https://github.com/jax-core/jaxcore/tree/main/Core) (Desktop skins), [`CoreShell/Home/script.js`](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Home/script.js) (Core home), [`CoreShell/Setting/script.js`](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Setting/script.js) (Settings UI), [`CoreShell/Help.inc`](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Help.inc) (Help and supporter pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Core interface"]
  node_home["Core home<br/>[script.js]"]
  node_settings["Settings UI<br/>[script.js]"]
  node_settingdata["Settings definitions<br/>[pageList.js]"]
  node_coreviews["Core views"]
  node_interaction["Interaction dialogs"]
end

subgraph group_management["Module management"]
  node_installer["Installation<br/>[CoreInstaller.ps1]"]
  node_updater["Update and rollback<br/>[Update.ps1]"]
  node_library["Module library"]
  node_modulecatalog["Modules and widgets<br/>[Modules.inc]"]
end

subgraph group_runtime["Desktop runtime"]
  node_skins["Desktop skins"]
  node_hotkeys["Hotkeys and actions<br/>[Hotkey.AHK]"]
  node_media["Media features<br/>[MediaPlayers.lua]"]
  node_widgets["Widget helpers<br/>[Combilaunch.lua]"]
  node_context["Context menus<br/>[Main.ini]"]
  node_window["Window interactions<br/>[WindowHandler.lua]"]
end

subgraph group_support["Support experience"]
  node_supportpages["Help and supporter pages<br/>[Help.inc]"]
end

node_user(("Desktop user"))
node_rainmeter(("Rainmeter"))
node_discord(("Community support"))

node_user -->|"opens"| node_home
node_user -->|"configures"| node_settings
node_home -.->|"navigates"| node_settings
node_settingdata -->|"renders controls"| node_settings
node_user -->|"installs"| node_installer
node_user -->|"browses"| node_library
node_user -->|"updates"| node_updater
node_user -.->|"responds to"| node_interaction
node_modulecatalog -.->|"lists modules"| node_home
node_rainmeter -.->|"runs"| node_skins
node_skins -.->|"uses actions"| node_hotkeys
node_skins -.->|"uses media helpers"| node_media
node_skins -.->|"uses widget helpers"| node_widgets
node_skins -.->|"provides menus"| node_context
node_skins -.->|"handles windows"| node_window
node_user -->|"seeks help"| node_supportpages
node_supportpages -->|"directs to"| node_discord

click node_home "https://github.com/jax-core/jaxcore/blob/main/CoreShell/Home/script.js"
click node_settings "https://github.com/jax-core/jaxcore/blob/main/CoreShell/Setting/script.js"
click node_settingdata "https://github.com/jax-core/jaxcore/blob/main/CoreShell/Setting/pageList.js"
click node_coreviews "https://github.com/jax-core/jaxcore/tree/main/CoreShell"
click node_installer "https://github.com/jax-core/jaxcore/blob/main/CoreInstaller.ps1"
click node_updater "https://github.com/jax-core/jaxcore/blob/main/%40Resources/Powershell/Update.ps1"
click node_library "https://github.com/jax-core/jaxcore/blob/main/%40Resources/Powershell/LibraryPageHelper.ps1"
click node_modulecatalog "https://github.com/jax-core/jaxcore/blob/main/CoreShell/Modules.inc"
click node_interaction "https://github.com/jax-core/jaxcore/tree/main/Accessories/GenericInteractionBox"
click node_skins "https://github.com/jax-core/jaxcore/tree/main/Core"
click node_hotkeys "https://github.com/jax-core/jaxcore/blob/main/%40Resources/Actions/Hotkey.AHK"
click node_media "https://github.com/jax-core/jaxcore/blob/main/%40Resources/Lua/Vault/MediaPlayers.lua"
click node_widgets "https://github.com/jax-core/jaxcore/blob/main/%40Resources/Lua/Vault/Combilaunch.lua"
click node_context "https://github.com/jax-core/jaxcore/blob/main/Ctx/Main.ini"
click node_window "https://github.com/jax-core/jaxcore/blob/main/%40Resources/Includes/GenericWindow/WindowHandler.lua"
click node_supportpages "https://github.com/jax-core/jaxcore/blob/main/CoreShell/Help.inc"

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_home,node_settings,node_settingdata,node_coreviews,node_interaction,node_user toneBlue
class node_installer,node_updater,node_library,node_modulecatalog toneAmber
class node_skins,node_hotkeys,node_media,node_widgets,node_context,node_window toneMint
class node_supportpages toneRose
class node_rainmeter,node_discord toneIndigo
```

## Components

### Core interface

- [Core home](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Home/script.js): `CoreShell/Home/script.js`
- [Settings UI](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Setting/script.js): `CoreShell/Setting/script.js`
- [Settings definitions](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Setting/pageList.js): `CoreShell/Setting/pageList.js`
- [Core views](https://github.com/jax-core/jaxcore/tree/main/CoreShell): `CoreShell`
- [Interaction dialogs](https://github.com/jax-core/jaxcore/tree/main/Accessories/GenericInteractionBox): `Accessories/GenericInteractionBox`

### Module management

- [Installation](https://github.com/jax-core/jaxcore/blob/main/CoreInstaller.ps1): `CoreInstaller.ps1`
- [Update and rollback](https://github.com/jax-core/jaxcore/blob/main/%40Resources/Powershell/Update.ps1): `@Resources/Powershell/Update.ps1`
- [Module library](https://github.com/jax-core/jaxcore/blob/main/%40Resources/Powershell/LibraryPageHelper.ps1): `@Resources/Powershell/LibraryPageHelper.ps1`
- [Modules and widgets](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Modules.inc): `CoreShell/Modules.inc`

### Desktop runtime

- [Desktop skins](https://github.com/jax-core/jaxcore/tree/main/Core): `Core`
- [Hotkeys and actions](https://github.com/jax-core/jaxcore/blob/main/%40Resources/Actions/Hotkey.AHK): `@Resources/Actions/Hotkey.AHK`
- [Media features](https://github.com/jax-core/jaxcore/blob/main/%40Resources/Lua/Vault/MediaPlayers.lua): `@Resources/Lua/Vault/MediaPlayers.lua`
- [Widget helpers](https://github.com/jax-core/jaxcore/blob/main/%40Resources/Lua/Vault/Combilaunch.lua): `@Resources/Lua/Vault/Combilaunch.lua`
- [Context menus](https://github.com/jax-core/jaxcore/blob/main/Ctx/Main.ini): `Ctx/Main.ini`
- [Window interactions](https://github.com/jax-core/jaxcore/blob/main/%40Resources/Includes/GenericWindow/WindowHandler.lua): `@Resources/Includes/GenericWindow/WindowHandler.lua`

### Support experience

- [Help and supporter pages](https://github.com/jax-core/jaxcore/blob/main/CoreShell/Help.inc): `CoreShell/Help.inc`

### Other components

- **Desktop user**
- **Rainmeter**
- **Community support**

## Connections

- Desktop user → Core home: opens (evidence: `README.md`)
- Desktop user → Settings UI: configures (evidence: `README.md`)
- Core home → Settings UI: navigates
- Settings definitions → Settings UI: renders controls (evidence: `CoreShell/Setting/script.js`)
- Desktop user → Installation: installs (evidence: `README.md`)
- Desktop user → Module library: browses (evidence: `README.md`)
- Desktop user → Update and rollback: updates (evidence: `README.md`)
- Desktop user → Interaction dialogs: responds to
- Modules and widgets → Core home: lists modules
- Rainmeter → Desktop skins: runs
- Desktop skins → Hotkeys and actions: uses actions
- Desktop skins → Media features: uses media helpers
- Desktop skins → Widget helpers: uses widget helpers
- Desktop skins → Context menus: provides menus
- Desktop skins → Window interactions: handles windows
- Desktop user → Help and supporter pages: seeks help (evidence: `README.md`)
- Help and supporter pages → Community support: directs to (evidence: `README.md`)
