Aurora OS.js

A modern, web-based desktop operating system interface built with React, Tailwind CSS, and Radix UI.

Features

• Desktop Environment: Windows 11-inspired grid layout, multi-select drag-and-drop, and fluid window management with snap-like behavior.
• Window Management: Minimize, maximize, close, and focus management with preserved state and independent navigation.
• Virtual Filesystem: Complete in-memory Linux-style filesystem (/bin, /etc, /home, etc.) with permissions and persistent storage.
• App Ecosystem:
  • Finder: Full-featured file manager with breadcrumbs navigation, drag-and-drop file moving, and list/grid views.
  • Terminal: Zsh-like experience with autocomplete, command history, pipe support, and ability to launch GUI apps (Finder /home).
  • Settings: System control panel for Appearance (Accent Colors, Themes), Performance (Motion/Shadows), and Data Management (Soft/Hard Reset).
  • Browser: Functional web browser simulation with bookmarks, history, and tab management.
  • Media: Interactive Music, Messages, and Photos apps demonstrating UI patterns.
• Security & Performance:
  • Content Security Policy: Strict CSP preventing XSS and eval execution in production.
  • Debounced Persistence: Efficiently saves state to localStorage without UI freezing.
  • Native Integration: Electron support with native window frame options and shell integration.
• Customization:
  • Theming: "2025" Color Palette with dynamic Neutral, Shades, and Contrast modes.
  • Accessibility: Reduce Motion and Disable Shadows options for lower-end devices.

Tech Stack

• Framework: React 19 (Vite 7)
• Styling: Tailwind CSS
• UI Primitives: Radix UI
• Icons: Lucide React
• Animation: Motion (Framer Motion)
• Testing: Vitest

Getting Started

1. Install dependencies:

   npm install

2. Start the development server:

   npm run dev

3. Build for production:

   npm run build

Testing

This project uses Vitest for unit & integration testing.

npm test

Release Notes

v0.6.2-patch3

• Environment: Added Vite chunking for better performance.
• Desktop: Added dragging constrains to prevent Windows going off-screen.
• Filesystem: Improved special folders consistency (.Trash and .Config).
• Finder: Fixed visibility of hidden files. Terminal will show hidden files.
• Dock: Fixed active Window dot indicator to respect the accent color.
• Terminal: Fixed path display in prompt.
• Finder: Added full-path breadcrumbs to navigate through directories, with drag-to-move functionality.
• Finder: Fixed breadcrumbs to show correct path if opened from Terminal.
• Environment: Added Content Security Policy (CSP) to prevent XSS attacks, and other various web-standard security measures.

View full version history

License

Not yet available

AI disclosure

This project, "Aurora OS," is human-written, with AI tools assisting in documentation, GitHub integrations, bug testing, and roadmap tracking.