A highly interactive, browser-based Web Operating System built entirely with React and Vanilla CSS. Designed as a comprehensive capstone project, Pseudo-OS simulates a modern desktop environment, demonstrating advanced frontend engineering principles, state management architectures, and precise DOM manipulations without relying on heavy external UI frameworks.
Pseudo-OS bridges the gap between traditional web applications and desktop environments. It provides a cohesive, unified workspace where multiple simulated applications run concurrently, sharing a central virtual file system. The project strictly adheres to a robust academic syllabus, proving mastery over core web technologies through practical, real-world implementation.
- Repository: https://github.com/Inkesk-Dozing/Pseudo-OS
- Deployment Link: https://web-dev-2-capstone-pseudo-os.vercel.app/
Pseudo-OS comes pre-packaged with a suite of essential applications, all interacting with the core OS state:
- ๐ฅ๏ธ Desktop Environment: A responsive workspace featuring a live-updating clock, application dock, and dynamic glassmorphism aesthetics.
- ๐ File Explorer: A graphical interface to navigate the virtual file system. Supports directory traversal, file creation, deletion, and inline text editing.
- โจ๏ธ Terminal Emulator: A robust command-line interface directly connected to the OS file system. Supports standard POSIX-like commands:
ls,cd,pwd,mkdir,touch,cat,rm,echo,clear,whoami
- ๐ Notes Application: A persistent text editor that reads and writes
.txtand.mdfiles directly to the shared/Documentsdirectory. - โ Weather Dashboard: Real-time meteorological data integration via the Open-Meteo API, featuring dynamic iconography and async data fetching.
- ๐งฎ Calculator: A fully functional arithmetic calculator with a custom evaluation engine.
- โ๏ธ System Settings: Centralized configuration panel to toggle global themes (Dark/Light) and manage user profiles via
localStorage.
The project is built on a modern, lightweight foundation, intentionally avoiding CSS-in-JS libraries or utility frameworks like Tailwind to demonstrate raw CSS proficiency.
| Layer | Technology Choice | Rationale |
|---|---|---|
| Core Framework | React 18 (Functional Components) | Component-driven architecture and reactive state updates. |
| Routing Layer | React Router DOM v7 | Managing the active application state via URL paths. |
| Styling Engine | Vanilla CSS3 + CSS Variables | Achieving high-performance glassmorphism and custom themes without build-step overhead. |
| Iconography | Lucide React | Consistent, lightweight vector graphics. |
| Network & Data | Native Fetch API | Promise-based asynchronous external data retrieval. |
| Build Tool | Vite | Lightning-fast HMR and optimized production bundling. |
| State Management | React Context API + Hooks | Centralized global state without Redux overhead. |
The interaction model below demonstrates how Pseudo-OS initializes context providers and manages data flow between global state containers and individual simulated applications:
graph TD
subgraph Providers [Context & Providers]
M[main.jsx] --> FSC[FileSystemProvider]
M --> TC[ThemeProvider]
end
subgraph Core [OS Shell & Routing]
FSC --> App[App.jsx Routing]
TC --> App
App --> L[Layout.jsx]
L --> SB[Status Bar]
L --> D[Dock]
L --> DK[Desktop.jsx Workspace]
end
subgraph Windows [Window Manager]
DK --> W1[OSWindow: File Explorer]
DK --> W2[OSWindow: Terminal]
DK --> W3[OSWindow: Notes]
DK --> W4[OSWindow: Weather]
DK --> W5[OSWindow: Calculator]
DK --> W6[OSWindow: Settings]
end
subgraph StateShare [Virtual File System & Settings]
W1 <--> FSC
W2 <--> FSC
W3 <--> FSC
W6 <--> TC
end
style Providers fill:#1e1e2e,stroke:#313244,stroke-width:2px,color:#cdd6f4
style Core fill:#181825,stroke:#313244,stroke-width:2px,color:#cdd6f4
style Windows fill:#11111b,stroke:#313244,stroke-width:2px,color:#cdd6f4
style StateShare fill:#313244,stroke:#45475a,stroke-width:2px,color:#cdd6f4
This project was engineered to satisfy specific academic requirements, demonstrating mastery in four key units:
- Custom dragging logic for
OSWindowcomponents using native mouse events (mousedown,mousemove,mouseup). - Keyboard event listeners in the Terminal for command execution and arrow-key history navigation.
- Implementation of the Fetch API with
.then()/.catch()methodology in the Weather app. - Non-blocking
setIntervalmechanisms for the live Desktop clock. - Persistent state management using the browser's
localStorageAPI for themes and user profiles.
- Modular component design separating OS UI (Layout, Dock, Window) from specific application logic.
- Robust prop-passing and component composition patterns.
useContext: Engineering a globalFileSystemContextthat acts as the single source of truth for the Terminal, File Explorer, and Notes apps.useRef: Direct DOM access for auto-scrolling terminal outputs.useState/useEffect: Managing complex component lifecycles, data fetching states, and cleanup operations.
src/
โโโ context/
โ โโโ FileSystemContext.jsx # Shared virtual file system engine
โ โโโ ThemeContext.jsx # Global appearance state manager
โโโ components/
โ โโโ Layout.jsx # Global OS shell (Dock, Status Bar)
โ โโโ OSWindow.jsx # Reusable, draggable application container
โโโ pages/
โ โโโ Desktop.jsx # Main workspace interface
โ โโโ FileExplorer.jsx # Graphical FS navigator
โ โโโ Terminal.jsx # CLI FS navigator
โ โโโ Notes.jsx # FS-connected text editor
โ โโโ Weather.jsx # Async API consumer
โ โโโ Calculator.jsx # Logic and state computation
โ โโโ Settings.jsx # LocalStorage preference manager
โโโ App.jsx # Route definitions
โโโ main.jsx # Application entry point & Provider tree
โโโ index.css # Global design system & animations
To run Pseudo-OS locally, ensure you have Node.js (v16+) installed.
-
Clone the repository:
git clone https://github.com/Inkesk-Dozing/Pseudo-OS.git cd Pseudo-OS -
Install dependencies:
npm install
-
Launch the development environment:
npm run dev
-
Open your browser and navigate to
http://localhost:5173.
- Process Manager: Implement a task manager to show "running" apps rather than purely route-based rendering.
- Window Stacking (z-index): Allow overlapping windows with active-window focus management.
- Draggable Desktop Icons: Implement drag-and-drop API for desktop shortcuts.
- Persistent File System: Sync the virtual FS state to
IndexedDBso files survive browser refreshes.
We are committed to keeping Pseudo-OS secure. For information regarding supported versions, vulnerability reporting procedures, and disclosure policies, please refer to our Security Policy.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.