# yannicksong0106/dsh-550c-boot architecture

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

- Interactive diagram: https://gitdiagram.com/yannicksong0106/dsh-550c-boot
- Repository: https://github.com/yannicksong0106/dsh-550c-boot

## Overview

dsh-550c-boot is a DSH plugin that plays a 550C boot animation in the Web UI and adds settings for animation mode, color scheme, preview, and updates. The main workflow starts when the user opens the DSH client: the host injects an early cover, then the browser plugin mounts and plays the splash before revealing the interface. Update checks and installs use host routes. Source excerpts show the host and browser responsibilities; README statements support the higher-level handoffs and capabilities, so unsampled wiring is not expanded further.

Main entry points: [`src/client.js`](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js) (Browser plugin), [`lib/index.js`](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/lib/index.js) (Update routes), [`src/show.js`](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/show.js) (Boot sequence), [`src/assets.js`](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/assets.js) (Animation assets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host integration"]
  node_host["Host plugin<br/>[index.js]"]
  node_cover["First-frame cover<br/>[index.js]"]
  node_update_routes["Update routes<br/>[index.js]"]
end

subgraph group_browser["Browser experience"]
  node_client["Browser plugin<br/>[client.js]"]
  node_preferences["Mode preferences<br/>[client.js]"]
  node_overlay["Splash overlay<br/>[client.js]"]
  node_chrome["Desktop chrome<br/>[client.js]"]
end

subgraph group_animation["Animation content"]
  node_assets["Animation assets<br/>[assets.js]"]
  node_timeline["Boot sequence<br/>[show.js]"]
  node_enhancements["Content enhancements<br/>[enhance.js]"]
end

node_user(("DSH user"))
node_dsh["DSH Web UI"]
node_registry["npm registries"]
node_cli["DSH CLI"]

node_user -->|"opens client"| node_dsh
node_host -->|"injects early cover"| node_cover
node_cover -->|"covers boot card"| node_dsh
node_dsh -->|"loads plugin"| node_client
node_client -->|"mounts splash"| node_overlay
node_client -->|"reads mode"| node_preferences
node_user -->|"chooses mode"| node_preferences
node_overlay -->|"uses markup and styles"| node_assets
node_overlay -->|"plays sequence"| node_timeline
node_timeline -->|"receives enhancements"| node_enhancements
node_client -->|"styles titlebar"| node_chrome
node_client -->|"requests updates"| node_update_routes
node_update_routes -->|"checks versions"| node_registry
node_update_routes -->|"runs install"| node_cli
node_user -->|"checks or applies update"| node_client

click node_host "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/lib/index.js"
click node_cover "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/lib/index.js"
click node_update_routes "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/lib/index.js"
click node_client "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js"
click node_preferences "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js"
click node_overlay "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js"
click node_chrome "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js"
click node_assets "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/assets.js"
click node_timeline "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/show.js"
click node_enhancements "https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/enhance.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_host,node_cover,node_update_routes,node_user,node_dsh toneBlue
class node_client,node_preferences,node_overlay,node_chrome toneAmber
class node_assets,node_timeline,node_enhancements toneMint
class node_registry,node_cli toneIndigo
```

## Components

### Host integration

- [Host plugin](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/lib/index.js): `lib/index.js`
- [First-frame cover](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/lib/index.js): `lib/index.js`
- [Update routes](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/lib/index.js): `lib/index.js`

### Browser experience

- [Browser plugin](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js): `src/client.js`
- [Mode preferences](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js): `src/client.js`
- [Splash overlay](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js): `src/client.js`
- [Desktop chrome](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/client.js): `src/client.js`

### Animation content

- [Animation assets](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/assets.js): `src/assets.js`
- [Boot sequence](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/show.js): `src/show.js`
- [Content enhancements](https://github.com/yannicksong0106/dsh-550c-boot/blob/main/src/enhance.js): `src/enhance.js`

### Other components

- **DSH user**
- **DSH Web UI**
- **npm registries**
- **DSH CLI**

## Connections

- DSH user → DSH Web UI: opens client (evidence: `README.md`)
- Host plugin → First-frame cover: injects early cover (evidence: `lib/index.js`)
- First-frame cover → DSH Web UI: covers boot card (evidence: `README.md`)
- DSH Web UI → Browser plugin: loads plugin (evidence: `README.md`)
- Browser plugin → Splash overlay: mounts splash (evidence: `src/client.js`)
- Browser plugin → Mode preferences: reads mode (evidence: `src/client.js`)
- DSH user → Mode preferences: chooses mode (evidence: `README.md`)
- Splash overlay → Animation assets: uses markup and styles (evidence: `README.md`)
- Splash overlay → Boot sequence: plays sequence (evidence: `README.md`)
- Boot sequence → Content enhancements: receives enhancements (evidence: `src/enhance.js`)
- Browser plugin → Desktop chrome: styles titlebar (evidence: `README.md`)
- Browser plugin → Update routes: requests updates (evidence: `README.md`)
- Update routes → npm registries: checks versions (evidence: `lib/index.js`)
- Update routes → DSH CLI: runs install (evidence: `lib/index.js`)
- DSH user → Browser plugin: checks or applies update (evidence: `README.md`)
