How qxii2027/zwebos works
WebOS is a macOS-style desktop environment implemented in the browser. Users unlock into a desktop, launch built-in apps, and work with windows and locally persisted OS state; the README highlights window management, a dock/menu bar, and an app ecosystem. The graph preserves those documented capabilities and sampled app/store modules. Several shell and app internals were not excerpted, so documented links use README evidence rather than implying source inspection.
Main entry points: DesktopOS.tsx Desktop OS · store.ts OS state store · AppRenderer.tsx App renderer · Window.tsx Window frame
Components 22
Entry and shell
- Desktop OS
src/components/os/DesktopOS.tsx - Lock screen
src/components/os/LockScreen.tsx - Desktop view
src/components/os/Desktop.tsx - Dock and menu
src/components/os/Dock.tsx - Menu bar
src/components/os/MenuBar.tsx - Start menu
src/components/os/StartMenu.tsx - Global shortcuts
src/components/os/useGlobalShortcuts.ts
Window management
- Window frame
src/components/os/Window.tsx - Drag and resize
src/components/os/useWindowDrag.ts - Window switcher
src/components/os/WindowSwitcher.tsx - Taskbar
src/components/os/Taskbar.tsx
Built-in apps
- App catalog
src/lib/os/defaultApps.ts - App icons
src/components/os/AppIcon.tsx - App renderer
src/components/os/AppRenderer.tsx - File manager
src/components/apps/FileManager.tsx - Music player
src/components/apps/MusicPlayer.tsx - Clock tools
src/components/apps/Clock.tsx - Other built-in apps
src/components/apps
OS state
- OS state store
src/lib/os/store.ts - OS data types
src/lib/os/types.ts
Other components
- Browser user
- Browser local storage
Connections 25
- Browser user → Lock screen: unlocks
README.md - Lock screen → Desktop OS: enters desktop
README.md - Desktop OS → Desktop view: presents
- Desktop OS → Dock and menu: provides launch controls
README.md - Desktop OS → Menu bar: provides controls
README.md - Desktop OS → Start menu: offers app access
- Desktop OS → Global shortcuts: handles shortcuts
- Dock and menu → App icons: displays icons
- Menu bar → App icons: uses icons
src/components/os/MenuBar.tsx - Start menu → App catalog: lists apps
- Desktop OS → Window frame: manages windows
README.md - Window frame → Drag and resize: uses gestures
- Window frame → App renderer: renders app
- Desktop OS → Window switcher: switches windows
README.md - Desktop OS → Taskbar: tracks windows
- App catalog → OS state store: seeds app definitions
src/lib/os/store.ts - OS state store → OS data types: uses data types
src/lib/os/store.ts - OS state store → Browser local storage: persists state
src/lib/os/store.ts - App renderer → File manager: renders app
- App renderer → Music player: renders app
- App renderer → Clock tools: renders app
- App renderer → Other built-in apps: renders apps
- File manager → OS state store: reads and updates files
src/components/apps/FileManager.tsx - Music player → OS state store: reads settings and notifies
src/components/apps/MusicPlayer.tsx - Clock tools → OS state store: uses OS state
src/components/apps/Clock.tsx