How amerhanna/ameros works
AmerOS is a browser-based desktop simulation. A user enters through the Next.js page, opens applications from the desktop shell, and works with virtual files, registry settings, and app-scoped or shared databases. The shell’s window engine manages launches and window state; individual application families provide file management, productivity, media, and system tools. The README documents these system capabilities, while excerpts directly confirm window orchestration, registry-backed app services, and database-to-VFS persistence. Other application wiring is represented only at the documented capability level.
Main entry points: WindowManager.tsx Window manager · vfs.ts Virtual filesystem · useWindowEngine.ts Window engine · registry.ts System registry
Components 20
Desktop shell
- Desktop entry
app/page.tsx - Window manager
components/WindowManager/WindowManager.tsx - Window engine
hooks/useWindowEngine.ts - Window frame
components/WindowManager/Window.tsx - Start menu
components/WindowManager/StartMenu.tsx - Taskbar
components/WindowManager/Taskbar.tsx
OS services
- App services
lib/app-service.ts - File associations
lib/file-service.ts - System dialogs
components/SystemDialogs/OpenFileDialog.tsx - Database hooks
hooks/useDatabase.ts - Database service
lib/database.ts
Applications
- File explorer
Applications/FileExplorer/FileExplorer.tsx - Productivity apps
Applications/Notes/Notes.tsx - Media apps
Applications/MusicPlayer/MusicPlayer.tsx - System tools
Applications/DBExplorer/DBExplorer.tsx
Persistent state
- System registry
lib/registry.ts - Virtual filesystem
lib/vfs.ts - Window state store
lib/window-store.ts
Other components
- Desktop user
- Browser storage
Connections 20
- Desktop user → Desktop entry: opens
- Desktop entry → Window manager: renders
- Window manager → Window engine: orchestrates
- Window engine → App services: launches apps
- Window engine → Window state store: updates state
- Window engine → Browser storage: persists preferences
- Window manager → Window frame: renders windows
- Window manager → Start menu: renders menu
- Window manager → Taskbar: renders taskbar
- Window manager → System registry: reads settings
- Window manager → Virtual filesystem: reads wallpaper
- App services → System registry: manages app entries
- File associations → System registry: resolves associations
- System dialogs → File explorer: selects files
- Database hooks → Database service: queries
- Database service → Virtual filesystem: loads and saves
- File explorer → Virtual filesystem: manages files
- Productivity apps → Virtual filesystem: uses files
- Media apps → Virtual filesystem: uses files
- System tools → Database hooks: explores data