Orbit OS – Stage 1 Stable Release
The Stage 1 Stable Release of Orbit OS establishes the foundation of a collaborative web-based desktop environment.
This milestone provides authentication, theming, window management, and a suite of starter applications, along with a stable CI pipeline and complete test coverage.
Key Features
Authentication
- JWT-based login, registration, and logout APIs (
src/pages/api/auth/
) - Profile management with avatar upload (
src/pages/api/users/avatar.js
) - User preference sync across sessions (
src/pages/api/users/preferences.js
) - Frontend forms:
LoginForm.js
,RegisterForm.js
,UserProfile.js
Theming and Styling
- Centralized theme registry (
src/themes/ThemeRegistry.js
) - Light, dark, and high-contrast themes
- Smooth theme transitions
- Configurable wallpapers (
public/backgrounds/
)
Desktop and Window Management
- Core components:
Desktop.js
,Window.js
,EnhancedWindow.js
,Taskbar.js
- Window snapping, resizing, and minimizing with previews
- Snap/resize logic under
src/system/services/
andsrc/system/components/
- Taskbar indicators and user profile integration
Applications
- Notes (
src/pages/apps/notes.js
,NotesApp.js
) - Browser (
src/pages/apps/browser.js
,BrowserApp.js
) - File Manager (
src/pages/apps/filemanager.js
,FilemanagerApp.js
) - Calculator (
src/pages/apps/calculator.js
,Calculator.js
) - Monitor (
src/pages/apps/monitor.js
,MonitorApp.js
) - Settings (
src/pages/apps/settings.js
,SettingsApp.js
) - Dynamic app registration through
AppRegistry.js
Developer and Testing Improvements
- Jest mocks for Framer Motion (
tests/__mocks__/framer-motion.js
) - Integration tests for window resizing and snapping
- CI pipeline passing with consistent test results
- Configurable deployment (
vercel.json
,DEPLOYMENT.md
)
Release Statistics
- 41+ files modified
- 15 commits
- ~1,888 lines of new code
- 100% test suite passing
Project Structure (Stage 1 Snapshot)
OrbitOS/
├── public/
│ ├── backgrounds/ # Wallpapers
│ └── icons/ # App icons
├── src/
│ ├── components/ # Core UI (Desktop, Taskbar, Window, etc.)
│ ├── context/ # React Context (App, Auth, Settings, Theme)
│ ├── hooks/ # Custom hooks for window management
│ ├── lib/ # Utility libraries (auth, db)
│ ├── models/ # Mongoose models (User)
│ ├── pages/ # Next.js pages & API routes
│ │ ├── api/ # Auth, users, files, health
│ │ ├── apps/ # Built-in applications
│ │ ├── auth.js # Auth page
│ │ ├── index.js # Desktop entry
│ │ ├── login.js
│ │ └── register.js
│ ├── styles/ # Global CSS
│ ├── system/ # Core OS logic, apps, services, strategies
│ └── themes/ # Light, dark, high-contrast themes
├── tests/ # Unit & integration tests
├── docs/ # Documentation
├── LICENSE
├── README.md
├── package.json
└── tailwind.config.js
Access at:
Demo: https://orbitos.codehubbers.com
UI: http://localhost:3000/
API routes: http://localhost:3000/api/*
Acknowledgments
Stage 1 was developed with contributions from the CodeHubbers community.
Thanks to @efecan0, @CoderRC @Atharv3221 @IsmailBinMujeeb @ethical-buddy @Ziqian-Huang0607 and all collaborators who improved authentication, theming, and test stability.