# chienminh21/soraxhikaru architecture

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

- Interactive diagram: https://gitdiagram.com/chienminh21/soraxhikaru
- Repository: https://github.com/chienminh21/soraxhikaru

## Overview

Sora x Hikaru is presented as a Roblox UI library, with a loader entry point and a configurable interface-building workflow: developers load the library, create a window and tabs, add modules and controls, then load the interface. The README also documents themes, notifications, dialogs, progress bars, configuration, backgrounds, and watermarks. The tree contains a separate Auth subsystem, but no source excerpts or README details establish its runtime behavior or how it connects to the UI, so those relationships are left unspecified.

Main entry points: [`Lib/UI.lua`](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua) (UI library), [`v/Loader.lua`](https://github.com/chienminh21/soraxhikaru/blob/main/v/Loader.lua) (Script loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry point"]
  node_loader["Script loader<br/>[Loader.lua]"]
end

subgraph group_ui["UI runtime"]
  node_library["UI library<br/>[UI.lua]"]
  node_window["Window<br/>[UI.lua]"]
  node_tabs["Tabs<br/>[UI.lua]"]
  node_modules["Modules<br/>[UI.lua]"]
  node_controls["UI controls<br/>[UI.lua]"]
end

subgraph group_features["Interface capabilities"]
  node_themes["Theme management<br/>[UI.lua]"]
  node_notifications["Notifications<br/>[UI.lua]"]
  node_dialogs["Confirmation dialogs<br/>[UI.lua]"]
  node_progress["Progress bar<br/>[UI.lua]"]
  node_configuration["Configuration management<br/>[UI.lua]"]
  node_backgrounds["Background customization<br/>[UI.lua]"]
  node_watermark["Watermark<br/>[UI.lua]"]
end

subgraph group_auth["Authentication"]
  node_auth_manager["Auth manager<br/>[Manager.lua]"]
  node_auth_registry["Auth registry<br/>[Registry.lua]"]
  node_auth_providers["Auth providers"]
end

node_developer(("Developer"))

node_developer -->|"loads"| node_loader
node_developer -->|"loads"| node_library
node_library -->|"creates"| node_window
node_window -->|"creates"| node_tabs
node_tabs -->|"organizes"| node_modules
node_modules -->|"contains"| node_controls
node_library -->|"supports"| node_themes
node_library -->|"supports"| node_notifications
node_library -->|"supports"| node_dialogs
node_library -->|"supports"| node_progress
node_library -->|"supports"| node_configuration
node_library -->|"supports"| node_backgrounds
node_library -->|"supports"| node_watermark

click node_loader "https://github.com/chienminh21/soraxhikaru/blob/main/v/Loader.lua"
click node_library "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_window "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_tabs "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_modules "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_controls "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_themes "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_notifications "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_dialogs "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_progress "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_configuration "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_backgrounds "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_watermark "https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua"
click node_auth_manager "https://github.com/chienminh21/soraxhikaru/blob/main/Auth/Manager.lua"
click node_auth_registry "https://github.com/chienminh21/soraxhikaru/blob/main/Auth/Registry.lua"
click node_auth_providers "https://github.com/chienminh21/soraxhikaru/tree/main/Auth/Services"

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_loader toneBlue
class node_library,node_window,node_tabs,node_modules,node_controls toneAmber
class node_themes,node_notifications,node_dialogs,node_progress,node_configuration,node_backgrounds,node_watermark toneMint
class node_auth_manager,node_auth_registry,node_auth_providers toneRose
class node_developer toneIndigo
```

## Components

### Entry point

- [Script loader](https://github.com/chienminh21/soraxhikaru/blob/main/v/Loader.lua): `v/Loader.lua`

### UI runtime

- [UI library](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Window](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Tabs](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Modules](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [UI controls](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`

### Interface capabilities

- [Theme management](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Notifications](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Confirmation dialogs](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Progress bar](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Configuration management](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Background customization](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`
- [Watermark](https://github.com/chienminh21/soraxhikaru/blob/main/Lib/UI.lua): `Lib/UI.lua`

### Authentication

- [Auth manager](https://github.com/chienminh21/soraxhikaru/blob/main/Auth/Manager.lua): `Auth/Manager.lua`
- [Auth registry](https://github.com/chienminh21/soraxhikaru/blob/main/Auth/Registry.lua): `Auth/Registry.lua`
- [Auth providers](https://github.com/chienminh21/soraxhikaru/tree/main/Auth/Services): `Auth/Services`

### Other components

- **Developer**

## Connections

- Developer → Script loader: loads (evidence: `README.md`)
- Developer → UI library: loads (evidence: `README.md`)
- UI library → Window: creates (evidence: `README.md`)
- Window → Tabs: creates (evidence: `README.md`)
- Tabs → Modules: organizes (evidence: `README.md`)
- Modules → UI controls: contains (evidence: `README.md`)
- UI library → Theme management: supports (evidence: `README.md`)
- UI library → Notifications: supports (evidence: `README.md`)
- UI library → Confirmation dialogs: supports (evidence: `README.md`)
- UI library → Progress bar: supports (evidence: `README.md`)
- UI library → Configuration management: supports (evidence: `README.md`)
- UI library → Background customization: supports (evidence: `README.md`)
- UI library → Watermark: supports (evidence: `README.md`)
