ryOS — Web-based Desktop Environment

What is ryOS — Web-based Desktop Environment?

ryOS is a modern web-based desktop environment inspired by classic macOS, built with React, TypeScript, and modern web technologies. It runs in the browser on any device—mobile, tablet, or desktop—and includes a suite of built-in applications like a file manager, text editor, graphics editor, video player, synthesizer, terminal, and more.

How to use ryOS — Web-based Desktop Environment?

Install dependencies with bun install, start a development server with bun dev, or build for production with bun run build. After starting, the desktop environment launches in the browser with a macOS-style interface. No additional configuration is required.

Key features of ryOS — Web-based Desktop Environment

• macOS-style window management with drag, resize, minimize, and maximize
• Built-in applications: Finder, TextEdit, MacPaint, Videos, Soundboard, Synth, and more
• Shader-powered background effects: CRT scanlines, Galaxy, and Aurora
• System-wide AI assistant (Ryo) integrated into Terminal and Chats
• One-click Backup/Restore using localStorage and IndexedDB
• Local persistence for all apps (documents, sounds, video playlists, etc.)

Use cases of ryOS — Web-based Desktop Environment

• A retro-inspired desktop experience accessible from any browser
• Running classic apps (paint, music player, DOS games) without a local install
• Experimenting with shader effects and system-wide audio customization
• Using an AI assistant to control apps, edit documents, or chat across the environment

FAQ from ryOS — Web-based Desktop Environment

What runtime does ryOS require?

For development, Bun is required. The production build is a static web app deployable to any hosting service (e.g., Vercel).

Where does user data persist?

All app data is saved locally in the browser using localStorage and IndexedDB. Users can create one-click backups and restores.

Can I customize the desktop appearance?

Yes. The Control Panels app allows selecting wallpapers (photos, patterns, or videos) and shader effects (CRT, Galaxy, Aurora). System-wide sounds can be toggled per app.

Is there any server-side component?

The project includes an api/ directory for backend endpoints, but the core desktop environment runs entirely client‑side in the browser.

Does ryOS work on mobile devices?

Yes. The interface is responsive and touch-friendly, working on mobile and tablet devices alongside desktop.