A modern, web-based operating system built with React, TypeScript, and Vite. Experience a fully interactive desktop environment with a sleek glassmorphism UI, complete with native-like applications and a dynamic app ecosystem.
A full-featured file explorer with context menus (Open, Delete, Rename, Download, About), drag-and-drop support, and seamless navigation through your virtual filesystem. Features glassmorphic design with smooth animations.
A powerful split-pane text editor supporting custom file types. Edit multiple files side-by-side with syntax awareness, perfect for coding and note-taking within the OS environment.
Integrated music player with manifest-based library management. Play, pause, skip tracks, and browse your music collection with a beautiful, responsive interface.
Full-featured web browser built right into the OS! Navigate the web and enjoy a complete browsing experience without leaving the desktop environment. The browser is a standout feature that brings true web capabilities to your virtual OS.
Interactive terminal emulator with support for basic Linux commands. Not a full-fledged shell, but powerful enough for file operations, navigation, and system interactions—perfect for power users who want command-line access.
Discover and install new applications directly from the built-in app store. Expand your OS capabilities with curated apps and tools designed for the aymu ecosystem.
- Framework: Vite + React (TSX)
- Language: TypeScript
- Styling: Vanilla CSS with custom design tokens
- State Management: Custom stores (
src/stores/systemStore.ts) - Build Tool: Vite dev server (
npm run dev)
# Clone the repository
git clone https://github.com/indgeek/aymu-os.git
cd aymu-os
# Install dependencies
npm install
# Run the development server
npm run devOpen http://localhost:8080 in your browser to see the OS in action.
aymu-os/
├── index.html # Root entrypoint
├── src/
│ ├── components/
│ │ └── os/ # Core OS UI components (BootScreen, Desktop, TopBar)
│ ├── stores/
│ │ └── systemStore.ts # Global state management
│ └── ...
└── ...
Entrypoint: The application starts from index.html in the root directory, which loads the React application. Core OS components live in src/components/os/, and global state is managed through src/stores/systemStore.ts.
Contributions are welcome! Please follow these steps:
- Fork the repository.
- Create a feature branch (
git checkout -b feature/awesome-feature). - Ensure code follows the existing style and passes linting.
- Submit a pull request with a clear description of changes.