How lidarbtc/hayeon-os works
HaYeon OS is a bilingual, Windows XP/7-inspired web desktop for a HaYeon fan community. Visitors boot into a welcome screen, log in to the desktop, then launch windows and use built-in apps for files, photos, music, games, profiles, and a guestbook. The map includes the desktop lifecycle, window management, app registration, and the main domain services. Edges are limited to relationships visible in excerpts or SOURCE INDEX references; unsampled implementations and their internal behavior are not inferred.
Main entry points: App.svelte App entry · Explorer.svelte File explorer · Terminal.svelte Terminal · apps.ts App registration
Components 31
Desktop lifecycle
- App entry
src/App.svelte - Session state
src/lib/os/session.svelte.ts - Boot screen
src/lib/screens/Boot.svelte - Welcome screen
src/lib/screens/Welcome.svelte - Leaving screen
src/lib/screens/Leaving.svelte - Power-off screen
src/lib/screens/Off.svelte
Desktop shell
- Desktop shell
src/lib/shell/Desktop.svelte - Window manager
src/lib/os/wm.svelte.ts - App registry
src/lib/os/registry.ts - App registration
src/lib/os/apps.ts - Icon renderer
src/lib/ui/Icon.svelte - Menu bar
src/lib/ui/MenuBar.svelte
Built-in apps
- File explorer
src/lib/apps/Explorer.svelte - Notepad
src/lib/apps/Notepad.svelte - Terminal
src/lib/apps/Terminal.svelte - Other desktop apps
src/lib/apps - Hedgehog game logic
src/lib/os/hog.ts
OS services
- Disk model
src/lib/os/disk.ts - User filesystem
src/lib/os/fs.svelte.ts - Shell shortcuts
src/lib/os/shell.ts - User settings
src/lib/os/settings.svelte.ts - Localization
src/lib/os/i18n.ts - Pointer state
src/lib/os/pointer.ts - Pack cache
src/lib/os/pack.svelte.ts
Media and community
- Photo library
src/lib/os/photos.svelte.ts - Media player
src/lib/os/player.svelte.ts - Music engine
src/lib/os/synth.ts - Music scores
src/lib/os/score.ts - Guestbook service
src/lib/os/guestbook.svelte.ts - Nostr integration
src/lib/os/nostr.ts
Other components
- Visitor
Connections 39
- Visitor → App entry: opens
README.md - App entry → Session state: reads phase
src/App.svelte - App entry → Boot screen: renders
src/App.svelte - App entry → Welcome screen: renders
src/App.svelte - App entry → Desktop shell: renders
src/App.svelte - App entry → Leaving screen: renders
src/App.svelte - App entry → Power-off screen: renders
src/App.svelte - Welcome screen → Session state: logs in
src/lib/screens/Welcome.svelte - Session state → Window manager: requests closes
src/lib/os/session.svelte.ts - App registration → App registry: registers apps
src/lib/os/apps.ts - Window manager → App registry: looks up apps
src/lib/os/wm.svelte.ts - App registration → File explorer: registers
src/lib/os/apps.ts - App registration → Notepad: registers
src/lib/os/apps.ts - App registration → Terminal: registers
src/lib/os/apps.ts - App registration → Other desktop apps: registers
src/lib/os/apps.ts - File explorer → Disk model: reads
src/lib/apps/Explorer.svelte - File explorer → User filesystem: reads
src/lib/apps/Explorer.svelte - Notepad → User filesystem: reads and writes
src/lib/apps/Notepad.svelte - Terminal → Disk model: reads
src/lib/apps/Terminal.svelte - Terminal → User filesystem: reads
src/lib/apps/Terminal.svelte - Terminal → User settings: reads
src/lib/apps/Terminal.svelte - Terminal → Shell shortcuts: uses shortcuts
src/lib/apps/Terminal.svelte - Terminal → Window manager: closes window
src/lib/apps/Terminal.svelte - Shell shortcuts → User filesystem: checks files
src/lib/os/shell.ts - Shell shortcuts → Window manager: opens apps
src/lib/os/shell.ts - File explorer → Pointer state: uses pointer state
src/lib/apps/Explorer.svelte - Notepad → Pointer state: uses pointer state
src/lib/apps/Notepad.svelte - Media player → Music engine: uses
src/lib/os/player.svelte.ts - Media player → Music scores: loads scores
src/lib/os/player.svelte.ts - Music engine → Music scores: reads
src/lib/os/synth.ts - Guestbook service → Nostr integration: uses
src/lib/os/guestbook.svelte.ts - User settings → Photo library: uses photo data
src/lib/os/settings.svelte.ts - Boot screen → Pack cache: starts pack
src/lib/screens/Boot.svelte - File explorer → Icon renderer: renders icons
src/lib/apps/Explorer.svelte - File explorer → Menu bar: renders menu
- Other desktop apps → Hedgehog game logic: game logic
src/lib/apps/HedgehogFinder.svelte - Other desktop apps → Photo library: photo features
- Other desktop apps → Guestbook service: guestbook UI
- Other desktop apps → Media player: music UI
src/lib/apps/MediaPlayer.svelte