Overview

syaOS is a web-based desktop environment that brings the nostalgia of classic operating systems to modern browsers. Experience the charm of Mac OS X Aqua, System 7, Windows XP, and Windows 98—all running in your browser with 17 fully-functional apps, an AI assistant, and a complete virtual file system.

Whether you're exploring the retro aesthetics, building HTML applets, or chatting with Ryo (the AI assistant), syaOS offers a unique blend of nostalgia and modern web technology.

graph TB
    subgraph Presentation["Presentation Layer"]
        Apps[17 App Modules]
        UI[UI Components]
        Themes[4 Themes]
    end
    
    subgraph State["State Management"]
        Zustand[Zustand Stores]
    end
    
    subgraph Data["Data Layer"]
        IndexedDB[(IndexedDB)]
        LocalStorage[(LocalStorage)]
        API[Vercel API]
    end
    
    subgraph External["External Services"]
        AI[AI Providers]
        Pusher[Real-time]
        Redis[(Redis)]
    end
    
    Apps --> Zustand
    UI --> Zustand
    Zustand --> IndexedDB
    Zustand --> LocalStorage
    Zustand --> API
    API --> AI
    API --> Redis
    Apps --> Pusher

Quick Start

I want to...	Go to
Learn about the apps	Apps Overview
Understand the architecture	Architecture
Understand the API layer	API Architecture
Build with the framework	Application Framework
Work with AI features	AI System
Use the APIs	API Reference

Key Features

Multi-Theme Support: System 7, Mac OS X (Aqua), Windows XP, Windows 98

17 Built-in Apps: Finder, TextEdit, Paint, iPod, Terminal, Chats, and more
AI Assistant (Ryo): Chat, tool calling, app control, code generation
Virtual File System: IndexedDB-backed with lazy loading
Real-time Chat: Pusher-powered rooms with AI integration
Audio System: Synthesizer, soundboard, TTS, and UI sounds
Component Library: shadcn/ui + custom components with i18n

Tech Stack

Category	Technologies
Frontend	React 19, TypeScript, Tailwind CSS v4, shadcn/ui, Framer Motion
State	Zustand with localStorage/IndexedDB persistence
Audio	Tone.js, WaveSurfer.js, Web Audio API
3D	Three.js (shaders)
Text Editor	TipTap
Storage	IndexedDB, LocalStorage, Redis (Upstash)
AI	OpenAI, Anthropic, Google via Vercel AI SDK
Real-time	Pusher
Build	Vite, Bun
Desktop	Tauri (macOS, Windows, Linux)
Deployment	Vercel

Project Structure

├── _api/             # Vercel API endpoints (underscore prefix avoids double compilation)
├── public/           # Static assets
├── src/
│   ├── apps/         # 17 app modules
│   ├── components/   # Shared React components
│   ├── config/       # App registry
│   ├── hooks/        # 29 custom hooks
│   ├── lib/          # Libraries
│   ├── stores/       # 21 Zustand stores
│   ├── styles/       # CSS
│   ├── themes/       # 4 theme definitions
│   ├── types/        # TypeScript types
│   └── utils/        # Utility functions
├── src-tauri/        # Desktop app config
└── scripts/          # Build scripts