# WarphOS

> Web-based desktop operating system simulating Windows 10 with authentic MDL2 design, Virtual File System (ZenFS), WebAssembly emulators, and full in-browser developer tooling.

WarphOS (https://warph.online) is an open-source web desktop environment running entirely client-side in the browser. It features a complete Windows 10 shell (Start Menu, Taskbar, System Tray, Action Center, File Explorer), multi-role security (Admin, Guest, Protected User), client-side virtual file system with IndexedDB persistence, sandboxed apps, code editors (Monaco), media players (VLC, Webamp), and retro gaming emulators (NES, Quake III, Virtual x86, DOSBox).

## Core Capabilities

- **Desktop Shell**: Windows 10 desktop environment with authentic Fluent Design & Segoe MDL2 iconography, start menu, taskbar flyouts, volume controls, calendar, and window manager.
- **Virtual File System**: Client-side hierarchical file system powered by ZenFS and BrowserFS with IndexedDB backing, 9P server protocol, and cloud storage integration (Google Drive).
- **Security Architecture**: Role-based access control (Admin, User, Guest), hardened iframe sandboxing, anti-user enumeration logon screen, AES-GCM folder encryption, and zero hardcoded secrets.
- **Productivity & Developer Tools**: Monaco Editor (VS Code core), Terminal shell with bash-like commands, DevTools, Vim, Paint, PDF viewer, and TinyMCE rich text editor.
- **Media & Emulation**: VLC media player, Webamp (Winamp 2.9), photos viewer, NES emulator, DOSBox (js-dos), Virtual x86 hardware emulator, and retro games.
- **Client-Side Privacy**: 100% browser-based execution with zero mandatory server tracking. All files and user data are stored locally in the browser's IndexedDB.

## URLs & Entry Points

- [Desktop Environment](https://warph.online): Main interactive desktop session.
- [Sitemap](https://warph.online/sitemap.xml): Machine-readable XML sitemap for search engines and crawlers.
- [RSS Feed](https://warph.online/rss.xml): Updates and content feed.
- [Source Code (GitHub)](https://github.com/Wpnnt/WarphOS): Complete open-source repository (MIT License).
- [Full LLM Context](https://warph.online/llms-full.txt): Detailed architecture, components, API specs, and technical reference for AI models.

## Deep Links (Query Parameters)

- `https://warph.online/?app=FileExplorer`: Launch File Explorer directly.
- `https://warph.online/?app=Terminal`: Launch Terminal directly.
- `https://warph.online/?app=MonacoEditor`: Launch Monaco Editor.
- `https://warph.online/?app=Settings`: Launch Windows 10 Settings.
- `https://warph.online/?app=NES`: Launch NES emulator.
- `https://warph.online/?app=VLC`: Launch VLC media player.
- `https://warph.online/?url=<encoded-path>`: Open or view a specific virtual file or directory.

## Technical Stack

- **Framework**: Next.js 15 (React 19, TypeScript)
- **Styling**: Styled Components (MDL2 & Fluent Design tokens)
- **Virtual FS**: ZenFS + BrowserFS with IndexedDB
- **Emulators**: WebAssembly (WASM) / Web Workers
- **License**: MIT
- **Creator**: Warph (contact@warph.online) & Dustin Brett