# minhreal/sieusv-storage architecture

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

- Interactive diagram: https://gitdiagram.com/minhreal/sieusv-storage
- Repository: https://github.com/minhreal/sieusv-storage

## Overview

SieuSV-Storage is both a collection of standalone Roblox Luau plugins and the source repository for a read-only script catalog website. Roblox builders install and use plugins for tasks such as exploration, editing, importing, and UI utilities; website visitors browse/search scripts, inspect source and history, and may sign in or delete an account. The worker excerpt confirms GitHub history access, Google OAuth, and database-backed sessions. The frontend’s request wiring and several backend paths were not sampled, so those connections are marked unverified or omitted.

Main entry points: [`website/worker.js`](https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js) (API worker), [`website/index.html`](https://github.com/minhreal/sieusv-storage/blob/main/website/index.html) (Library interface), [`Sieu-SV Plugins/Advanced Explorer/Advanced Explorer.lua`](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Advanced%20Explorer/Advanced%20Explorer.lua) (Advanced Explorer), [`Sieu-SV Plugins/Surface Preview/Surface Preview.lua`](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Surface%20Preview/Surface%20Preview.lua) (Surface Preview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugins["Roblox plugins"]
  node_explorer["Advanced Explorer"]
  node_surface["Surface Preview"]
  node_weld["Weld<br/>[Weld.lua]"]
  node_grip["Grip Editor<br/>[GripEditor.lua]"]
  node_exportimport["Export-Import<br/>[EI-Source.lua]"]
  node_chat["Open Chat<br/>[Open Chat.lua]"]
  node_arrange["Button Arrangement"]
  node_stroke["UIStroke Utility"]
  node_draggable["Draggable Utility<br/>[Draggable.lua]"]
end

subgraph group_website["Library website"]
  node_frontend["Library interface<br/>[index.html]"]
  node_worker["API worker<br/>[worker.js]"]
  node_catalog["Script catalog<br/>[worker.js]"]
  node_history["Version history<br/>[worker.js]"]
end

subgraph group_accounts["Website accounts"]
  node_accounts["Account workflows<br/>[worker.js]"]
  node_store[("Website database<br/>[schema.sql]")]
end

subgraph group_integrations["External services"]
  node_github["GitHub API"]
  node_google["Google OAuth"]
end

node_builder(("Roblox builder"))
node_visitor(("Website visitor"))

node_builder -->|"uses"| node_explorer
node_builder -->|"uses"| node_surface
node_builder -->|"uses"| node_weld
node_builder -->|"uses"| node_grip
node_builder -->|"uses"| node_exportimport
node_builder -->|"uses"| node_chat
node_builder -->|"uses"| node_arrange
node_builder -->|"uses"| node_stroke
node_builder -->|"uses"| node_draggable
node_visitor -->|"browses"| node_frontend
node_frontend -.->|"requests catalog data"| node_worker
node_worker -->|"handles catalog"| node_catalog
node_worker -->|"routes history"| node_history
node_history -->|"fetches commits"| node_github
node_worker -->|"handles account routes"| node_accounts
node_accounts -->|"exchanges OAuth"| node_google
node_accounts -->|"reads sessions"| node_store
node_catalog -.->|"reads repository"| node_github

click node_explorer "https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Advanced%20Explorer/Advanced%20Explorer.lua"
click node_surface "https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Surface%20Preview/Surface%20Preview.lua"
click node_weld "https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Weld/Weld.lua"
click node_grip "https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Grip%20Editor/GripEditor.lua"
click node_exportimport "https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Export-Import%20Plugin/EI-Source.lua"
click node_chat "https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Open%20Chat/Open%20Chat.lua"
click node_arrange "https://github.com/minhreal/sieusv-storage/blob/main/Other/Automatic%20Button%20Arrangement/AutomaticButtonArrangement.lua"
click node_stroke "https://github.com/minhreal/sieusv-storage/blob/main/Other/Automatically%20Add%20UIStroke/AutomaticallyAddUIStroke.lua"
click node_draggable "https://github.com/minhreal/sieusv-storage/blob/main/Other/Draggable/Draggable.lua"
click node_frontend "https://github.com/minhreal/sieusv-storage/blob/main/website/index.html"
click node_worker "https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js"
click node_catalog "https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js"
click node_history "https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js"
click node_accounts "https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js"
click node_store "https://github.com/minhreal/sieusv-storage/blob/main/website/schema.sql"

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_explorer,node_surface,node_weld,node_grip,node_exportimport,node_chat,node_arrange,node_stroke,node_draggable toneBlue
class node_frontend,node_worker,node_catalog,node_history toneAmber
class node_accounts,node_store toneMint
class node_github,node_google toneRose
class node_builder,node_visitor toneIndigo
```

## Components

### Roblox plugins

- [Advanced Explorer](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Advanced%20Explorer/Advanced%20Explorer.lua): `Sieu-SV Plugins/Advanced Explorer/Advanced Explorer.lua`
- [Surface Preview](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Surface%20Preview/Surface%20Preview.lua): `Sieu-SV Plugins/Surface Preview/Surface Preview.lua`
- [Weld](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Weld/Weld.lua): `Sieu-SV Plugins/Weld/Weld.lua`
- [Grip Editor](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Grip%20Editor/GripEditor.lua): `Sieu-SV Plugins/Grip Editor/GripEditor.lua`
- [Export-Import](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Export-Import%20Plugin/EI-Source.lua): `Sieu-SV Plugins/Export-Import Plugin/EI-Source.lua`
- [Open Chat](https://github.com/minhreal/sieusv-storage/blob/main/Sieu-SV%20Plugins/Open%20Chat/Open%20Chat.lua): `Sieu-SV Plugins/Open Chat/Open Chat.lua`
- [Button Arrangement](https://github.com/minhreal/sieusv-storage/blob/main/Other/Automatic%20Button%20Arrangement/AutomaticButtonArrangement.lua): `Other/Automatic Button Arrangement/AutomaticButtonArrangement.lua`
- [UIStroke Utility](https://github.com/minhreal/sieusv-storage/blob/main/Other/Automatically%20Add%20UIStroke/AutomaticallyAddUIStroke.lua): `Other/Automatically Add UIStroke/AutomaticallyAddUIStroke.lua`
- [Draggable Utility](https://github.com/minhreal/sieusv-storage/blob/main/Other/Draggable/Draggable.lua): `Other/Draggable/Draggable.lua`

### Library website

- [Library interface](https://github.com/minhreal/sieusv-storage/blob/main/website/index.html): `website/index.html`
- [API worker](https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js): `website/worker.js`
- [Script catalog](https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js): `website/worker.js`
- [Version history](https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js): `website/worker.js`

### Website accounts

- [Account workflows](https://github.com/minhreal/sieusv-storage/blob/main/website/worker.js): `website/worker.js`
- [Website database](https://github.com/minhreal/sieusv-storage/blob/main/website/schema.sql): `website/schema.sql`

### External services

- **GitHub API**
- **Google OAuth**

### Other components

- **Roblox builder**
- **Website visitor**

## Connections

- Roblox builder → Advanced Explorer: uses (evidence: `README.md`)
- Roblox builder → Surface Preview: uses (evidence: `README.md`)
- Roblox builder → Weld: uses (evidence: `README.md`)
- Roblox builder → Grip Editor: uses (evidence: `README.md`)
- Roblox builder → Export-Import: uses (evidence: `README.md`)
- Roblox builder → Open Chat: uses (evidence: `README.md`)
- Roblox builder → Button Arrangement: uses (evidence: `README.md`)
- Roblox builder → UIStroke Utility: uses (evidence: `README.md`)
- Roblox builder → Draggable Utility: uses (evidence: `README.md`)
- Website visitor → Library interface: browses (evidence: `README.md`)
- Library interface → API worker: requests catalog data
- API worker → Script catalog: handles catalog (evidence: `website/worker.js`)
- API worker → Version history: routes history (evidence: `website/worker.js`)
- Version history → GitHub API: fetches commits (evidence: `website/worker.js`)
- API worker → Account workflows: handles account routes (evidence: `website/worker.js`)
- Account workflows → Google OAuth: exchanges OAuth (evidence: `website/worker.js`)
- Account workflows → Website database: reads sessions (evidence: `website/worker.js`)
- Script catalog → GitHub API: reads repository
