# sadinkai/sunday architecture

> Architecture diagram of the GitHub repository sadinkai/sunday, 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/sadinkai/sunday
- Repository: https://github.com/sadinkai/sunday

## Overview

SUNDAY is a Windows desktop Roblox account manager and multi-instance launcher. The main user flow is to add or select an account, choose a game or destination, review a launch, then monitor and control the clients SUNDAY started. Its runtime also supports browsing games and players, diagnostics, and settings. The graph follows the renderer-to-backend-to-launch path and highlights account persistence, isolation adapters, and process monitoring. Some subsystem links are based on README descriptions; unsampled implementation details are not inferred.

Main entry points: [`src/main/tauri-backend.js`](https://github.com/sadinkai/sunday/blob/main/src/main/tauri-backend.js) (Tauri backend), [`src/renderer/app.js`](https://github.com/sadinkai/sunday/blob/main/src/renderer/app.js) (Renderer app), [`src/renderer/actions.js`](https://github.com/sadinkai/sunday/blob/main/src/renderer/actions.js) (UI actions), [`src/main/roblox-isolation-adapter.js`](https://github.com/sadinkai/sunday/blob/main/src/main/roblox-isolation-adapter.js) (Isolation selector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_renderer["Renderer app<br/>[app.js]"]
  node_launchview["Launch view<br/>[launch.js]"]
  node_accountsview["Accounts view<br/>[accounts.js]"]
  node_peopleview["People view<br/>[people.js]"]
  node_gamesview["Games view<br/>[games.js]"]
  node_settingsview["Settings view<br/>[settings.js]"]
  node_diagnostics["Diagnostics view<br/>[diagnostics.js]"]
  node_actions["UI actions<br/>[actions.js]"]
end

subgraph group_backend["Application services"]
  node_backendentry["Tauri backend<br/>[tauri-backend.js]"]
  node_games["Game browsing<br/>[games.js]"]
  node_people["Player browsing<br/>[people.js]"]
  node_roblox["Roblox discovery<br/>[roblox.js]"]
  node_robloxservice["Roblox services<br/>[people.js]"]
end

subgraph group_launch["Launch and processes"]
  node_planner["Launch orchestration"]
  node_keeper["Client keeper<br/>[keeper.js]"]
  node_monitor["Process monitor<br/>[monitor.js]"]
  node_processes["Process operations<br/>[processes.js]"]
end

subgraph group_isolation["Runtime isolation"]
  node_adapter["Isolation selector"]
  node_legacy["Legacy compatibility"]
end

subgraph group_data["Accounts and state"]
  node_accounts["Account management<br/>[accounts.js]"]
  node_state[("Transactional state<br/>[state-database.js]")]
end

node_user(("SUNDAY user"))

node_user -->|"uses"| node_renderer
node_renderer -->|"shows launch"| node_launchview
node_renderer -->|"shows accounts"| node_accountsview
node_renderer -->|"shows players"| node_peopleview
node_renderer -->|"shows games"| node_gamesview
node_renderer -->|"shows settings"| node_settingsview
node_renderer -->|"shows diagnostics"| node_diagnostics
node_launchview -->|"requests actions"| node_actions
node_accountsview -->|"requests actions"| node_actions
node_peopleview -->|"requests actions"| node_actions
node_gamesview -->|"requests actions"| node_actions
node_settingsview -->|"requests actions"| node_actions
node_actions -.->|"invokes commands"| node_backendentry
node_backendentry -->|"calls"| node_accounts
node_backendentry -->|"calls"| node_games
node_backendentry -->|"calls"| node_people
node_accounts -->|"imports storage"| node_state
node_backendentry -->|"coordinates launches"| node_planner
node_planner -->|"imports adapter"| node_adapter
node_backendentry -->|"constructs keeper"| node_keeper
node_backendentry -->|"constructs monitor"| node_monitor
node_monitor -->|"imports process operations"| node_processes
node_backendentry -->|"uses discovery"| node_roblox
node_backendentry -->|"selects adapter"| node_adapter
node_adapter -->|"imports implementation"| node_legacy
node_people -->|"imports account services"| node_accounts

click node_renderer "https://github.com/sadinkai/sunday/blob/main/src/renderer/app.js"
click node_launchview "https://github.com/sadinkai/sunday/blob/main/src/renderer/views/launch.js"
click node_accountsview "https://github.com/sadinkai/sunday/blob/main/src/renderer/views/accounts.js"
click node_peopleview "https://github.com/sadinkai/sunday/blob/main/src/renderer/views/people.js"
click node_gamesview "https://github.com/sadinkai/sunday/blob/main/src/renderer/views/games.js"
click node_settingsview "https://github.com/sadinkai/sunday/blob/main/src/renderer/views/settings.js"
click node_diagnostics "https://github.com/sadinkai/sunday/blob/main/src/renderer/views/diagnostics.js"
click node_actions "https://github.com/sadinkai/sunday/blob/main/src/renderer/actions.js"
click node_backendentry "https://github.com/sadinkai/sunday/blob/main/src/main/tauri-backend.js"
click node_accounts "https://github.com/sadinkai/sunday/blob/main/src/main/accounts.js"
click node_games "https://github.com/sadinkai/sunday/blob/main/src/main/games.js"
click node_people "https://github.com/sadinkai/sunday/blob/main/src/main/people.js"
click node_state "https://github.com/sadinkai/sunday/blob/main/src/main/state-database.js"
click node_planner "https://github.com/sadinkai/sunday/blob/main/src/main/launch-orchestration.js"
click node_keeper "https://github.com/sadinkai/sunday/blob/main/src/main/keeper.js"
click node_monitor "https://github.com/sadinkai/sunday/blob/main/src/main/monitor.js"
click node_processes "https://github.com/sadinkai/sunday/blob/main/src/main/processes.js"
click node_adapter "https://github.com/sadinkai/sunday/blob/main/src/main/roblox-isolation-adapter.js"
click node_legacy "https://github.com/sadinkai/sunday/blob/main/src/main/legacy-roblox-isolation-adapter.js"
click node_roblox "https://github.com/sadinkai/sunday/blob/main/src/main/roblox.js"
click node_robloxservice "https://github.com/sadinkai/sunday/blob/main/src/main/people.js"

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_renderer,node_launchview,node_accountsview,node_peopleview,node_gamesview,node_settingsview,node_diagnostics,node_actions,node_user toneBlue
class node_backendentry,node_games,node_people,node_roblox,node_robloxservice toneAmber
class node_planner,node_keeper,node_monitor,node_processes toneMint
class node_adapter,node_legacy toneRose
class node_accounts,node_state toneIndigo
```

## Components

### Desktop interface

- [Renderer app](https://github.com/sadinkai/sunday/blob/main/src/renderer/app.js): `src/renderer/app.js`
- [Launch view](https://github.com/sadinkai/sunday/blob/main/src/renderer/views/launch.js): `src/renderer/views/launch.js`
- [Accounts view](https://github.com/sadinkai/sunday/blob/main/src/renderer/views/accounts.js): `src/renderer/views/accounts.js`
- [People view](https://github.com/sadinkai/sunday/blob/main/src/renderer/views/people.js): `src/renderer/views/people.js`
- [Games view](https://github.com/sadinkai/sunday/blob/main/src/renderer/views/games.js): `src/renderer/views/games.js`
- [Settings view](https://github.com/sadinkai/sunday/blob/main/src/renderer/views/settings.js): `src/renderer/views/settings.js`
- [Diagnostics view](https://github.com/sadinkai/sunday/blob/main/src/renderer/views/diagnostics.js): `src/renderer/views/diagnostics.js`
- [UI actions](https://github.com/sadinkai/sunday/blob/main/src/renderer/actions.js): `src/renderer/actions.js`

### Application services

- [Tauri backend](https://github.com/sadinkai/sunday/blob/main/src/main/tauri-backend.js): `src/main/tauri-backend.js`
- [Game browsing](https://github.com/sadinkai/sunday/blob/main/src/main/games.js): `src/main/games.js`
- [Player browsing](https://github.com/sadinkai/sunday/blob/main/src/main/people.js): `src/main/people.js`
- [Roblox discovery](https://github.com/sadinkai/sunday/blob/main/src/main/roblox.js): `src/main/roblox.js`
- [Roblox services](https://github.com/sadinkai/sunday/blob/main/src/main/people.js): `src/main/people.js`

### Launch and processes

- [Launch orchestration](https://github.com/sadinkai/sunday/blob/main/src/main/launch-orchestration.js): `src/main/launch-orchestration.js`
- [Client keeper](https://github.com/sadinkai/sunday/blob/main/src/main/keeper.js): `src/main/keeper.js`
- [Process monitor](https://github.com/sadinkai/sunday/blob/main/src/main/monitor.js): `src/main/monitor.js`
- [Process operations](https://github.com/sadinkai/sunday/blob/main/src/main/processes.js): `src/main/processes.js`

### Runtime isolation

- [Isolation selector](https://github.com/sadinkai/sunday/blob/main/src/main/roblox-isolation-adapter.js): `src/main/roblox-isolation-adapter.js`
- [Legacy compatibility](https://github.com/sadinkai/sunday/blob/main/src/main/legacy-roblox-isolation-adapter.js): `src/main/legacy-roblox-isolation-adapter.js`

### Accounts and state

- [Account management](https://github.com/sadinkai/sunday/blob/main/src/main/accounts.js): `src/main/accounts.js`
- [Transactional state](https://github.com/sadinkai/sunday/blob/main/src/main/state-database.js): `src/main/state-database.js`

### Other components

- **SUNDAY user**

## Connections

- SUNDAY user → Renderer app: uses (evidence: `README.md`)
- Renderer app → Launch view: shows launch (evidence: `README.md`)
- Renderer app → Accounts view: shows accounts (evidence: `README.md`)
- Renderer app → People view: shows players (evidence: `README.md`)
- Renderer app → Games view: shows games (evidence: `README.md`)
- Renderer app → Settings view: shows settings (evidence: `README.md`)
- Renderer app → Diagnostics view: shows diagnostics (evidence: `README.md`)
- Launch view → UI actions: requests actions (evidence: `README.md`)
- Accounts view → UI actions: requests actions (evidence: `README.md`)
- People view → UI actions: requests actions (evidence: `README.md`)
- Games view → UI actions: requests actions (evidence: `README.md`)
- Settings view → UI actions: requests actions (evidence: `README.md`)
- UI actions → Tauri backend: invokes commands
- Tauri backend → Account management: calls (evidence: `src/main/tauri-backend.js`)
- Tauri backend → Game browsing: calls (evidence: `src/main/tauri-backend.js`)
- Tauri backend → Player browsing: calls (evidence: `src/main/tauri-backend.js`)
- Account management → Transactional state: imports storage (evidence: `src/main/accounts.js`)
- Tauri backend → Launch orchestration: coordinates launches (evidence: `src/main/tauri-backend.js`)
- Launch orchestration → Isolation selector: imports adapter (evidence: `src/main/launch-orchestration.js`)
- Tauri backend → Client keeper: constructs keeper (evidence: `src/main/tauri-backend.js`)
- Tauri backend → Process monitor: constructs monitor (evidence: `src/main/tauri-backend.js`)
- Process monitor → Process operations: imports process operations (evidence: `src/main/monitor.js`)
- Tauri backend → Roblox discovery: uses discovery (evidence: `src/main/tauri-backend.js`)
- Tauri backend → Isolation selector: selects adapter (evidence: `src/main/tauri-backend.js`)
- Isolation selector → Legacy compatibility: imports implementation (evidence: `src/main/roblox-isolation-adapter.js`)
- Player browsing → Account management: imports account services (evidence: `src/main/people.js`)
