An interactive, high-fidelity macOS Sequoia desktop operating system portfolio built from scratch with React 19, Vite 7, Tailwind CSS v4, and SCSS.
Instead of a traditional static portfolio, this project turns your browser into a fully operational macOS environment featuring draggable & resizable multi-window management, an interactive Control Center with live system brightness and volume control, virtual file system simulation, Lo-Fi music audio suite, Spotlight Search (Cmd + K), and 10+ native apps showcasing projects, technical skills, resume, and contact channels.
๐ Experience Live macOS Portfolio
- Dynamic Window Manager (
react-rnd):- Independent active window focus with dynamic z-index stacking.
- Native macOS traffic light controls: Close, Minimize to Dock, and Full-screen Maximize / Restore.
- Fluid dragging with viewport constraint boundaries and smooth 8-direction resizing.
- Glass Top Menu Bar:
- Functional Apple Menu with quick links to About This Mac, System Preferences, Lock Screen, and Sleep.
- Contextual active window title indicator.
- Status items: Battery level, Wi-Fi status, Spotlight search toggle, and live digital clock with date format.
- Interactive Control Center:
- Real-time System Volume Slider controlling the built-in Lo-Fi background audio engine.
- Real-time Display Brightness Slider with live CSS backdrop filter illumination.
- Toggles for Wi-Fi, Bluetooth, AirDrop, and Dark Mode.
- Integrated music playback card with play/pause and skip controls.
- Spotlight Search (
Cmd + K/Ctrl + K):- Instant fuzzy app search overlay with keyboard navigation (
โ,โ,Enter,Escape).
- Instant fuzzy app search overlay with keyboard navigation (
- Interactive macOS Dock:
- Running app indicator dots.
- Hover tooltips and smooth scaling magnification.
- Quick launch for all system apps and desktop utilities.
- Desktop Environment & Context Menu:
- Desktop icons (
Macintosh HD,Dhruv_Resume.pdf,Projects,profile.config.ts,Bin) with click and double-click actions. - Right-click desktop context menu to change wallpapers, launch apps, or view system info.
- Desktop icons (
- Lock Screen:
- Authentic macOS login screen with avatar, blurred wallpaper backdrop, password validation shake animation, and lock/unlock toggle.
- Synthesized System Audio (Web Audio API):
- Custom procedural sound effects for window clicks, popups, and trash actions.
| App | Icon | Description |
|---|---|---|
| Finder | ๐ | Virtual file system explorer with Favorites (Desktop, Documents, Skills, Bin), toggleable Grid/List views, and search filtering. |
| Projects (GitHub) | ๐ | Project showcase with live filtering (Full-Stack, AI/ML, React, Tools), responsive dual-backdrop media, stack badges, live demo links, and modal image zoom. |
| Terminal (zsh) | ๐ป | Fully interactive terminal emulator supporting commands like help, about, skills, projects, contact, resume, whoami, clear, date, cat, and app launching. |
| Notes | ๐ | Multi-tab developer notebook simulating IDE files (profile.config.ts, projects.architecture.ts, experience.log, skills.json) with one-click code copy. |
| Resume (PDF) | ๐ | Dual-mode resume viewer with Digital View (pristine dark-mode resume) and PDF Viewer. Includes Download PDF (safe 60s blob), Open in Tab, and Print / Save as PDF (window.print()). |
| Safari | ๐งญ | macOS browser replica featuring tabs, URL bar, navigation buttons, bookmarks, and developer portfolio highlights. |
| Spotify & Lo-Fi | ๐ต | Dual-mode music player: In-house Dev Lo-Fi Player synchronized with macOS system volume (4 custom tracks) + official Spotify embed player. |
| iMessage | ๐ฌ | Interactive contact messenger with quick conversation prompts ("Let's collaborate!", "Schedule interview"), smart automated replies, and contact links. |
| Settings | โ๏ธ | System preferences for switching 4K macOS wallpapers (Sequoia, Sonoma, Cyberpunk, Ventura, Minimal), toggling sound effects, and dark mode. |
| Calculator | ๐งฎ | Functional macOS dark calculator with standard arithmetic operations and precision display. |
| About This Mac | ๐ | Hardware specs dialog featuring Apple M3 Max architecture, DhruvOS 15.2, Parul University 7.4 CGPA, memory, and graphics. |
- Core Framework: React 19
- Build Tool: Vite 7
- Styling: Tailwind CSS v4 & SCSS (Modular BEM-like SCSS, glassmorphism, responsive queries, and
@media printstylesheets) - Window Management:
react-rnd - Icons:
@remixicon/react - Terminal Emulator:
react-console-emulator - Audio Engine: HTML5 Audio API (Lo-Fi controller) + Web Audio API (procedural UI sound effects)
- State Management: React Context API (
WindowContext,SettingsContext)
Mac-OS/
โโโ public/
โ โโโ dhruv_aparnathi_resume.pdf # High-resolution resume PDF
โ โโโ note.txt # Developer notebook raw notes
โ โโโ wallpaper.png # Default 4K macOS background
โ โโโ doc-icons/ # Dock application icons
โ โโโ navbar-icons/ # Top menu bar icons
โโโ src/
โ โโโ assets/
โ โ โโโ github.json # Project showcase catalog & metadata
โ โโโ components/
โ โ โโโ common/ # MacWindow wrapper, traffic lights & resize handles
โ โ โโโ desktop/ # Desktop icons & right-click context menu
โ โ โโโ dock/ # macOS magnification dock & launch dots
โ โ โโโ lockscreen/ # macOS lock & login screen
โ โ โโโ navbar/ # Glass top bar, Apple menu, Control Center, Clock
โ โ โโโ spotlight/ # Cmd+K spotlight search overlay
โ โโโ context/
โ โ โโโ WindowContext.jsx # Multi-window state, z-index stacking, min/max
โ โ โโโ SettingsContext.jsx # Brightness, volume, audio, wallpaper & lock state
โ โโโ data/
โ โ โโโ filesystem.js # Virtual file system tree (Desktop, Documents, Skills)
โ โ โโโ wallpapers.js # Curated 4K wallpapers & accent palettes
โ โโโ utils/
โ โ โโโ audio.js # Global Lo-Fi audio controller with volume sync
โ โ โโโ sound.js # Synthesized Web Audio API sound effects
โ โโโ windows/ # 10 Modular macOS Application Components
โ โ โโโ about/ # About This Mac specs dialog
โ โ โโโ calculator/ # macOS dark calculator
โ โ โโโ cli/ # ZSH terminal emulator with custom commands
โ โ โโโ finder/ # Virtual file explorer with grid/list modes
โ โ โโโ github/ # Projects catalog with category filter & zoom
โ โ โโโ messages/ # iMessage contact form with interactive prompts
โ โ โโโ note/ # Multi-tab developer notebook
โ โ โโโ pdf/ # PDF viewer, digital resume & print-to-PDF
โ โ โโโ safari/ # Safari browser simulator
โ โ โโโ settings/ # Wallpaper switcher & sound settings
โ โ โโโ spotify/ # Lo-Fi player & Spotify embed
โ โโโ App.jsx # Main desktop shell & context providers
โ โโโ app.scss # Global desktop styles & glassmorphism filters
โ โโโ main.jsx # Application entry point
โโโ package.json
โโโ vite.config.js
โโโ README.md
| Shortcut | Action |
|---|---|
| โ Cmd + K / Ctrl + K | Toggle Spotlight Search |
| Esc | Close Spotlight / Dismiss Open Menus |
| โ / โ | Navigate Spotlight search results |
| Enter | Launch selected app in Spotlight |
Launch the Terminal from the Dock or Desktop and try these commands:
help # List all available terminal commands
about # Print professional summary & background
skills # Display full frontend, backend, and AI tech stack
projects # View featured projects overview
contact # Get email, phone, LinkedIn, and GitHub links
resume # Open the Resume viewer window
finder # Open macOS Finder
safari # Open Safari browser
whoami # Display current logged-in developer profile
date # Show current system date and time
clear # Clear the terminal screen- Node.js >= 18.0.0
- npm >= 9.0.0 (or pnpm / yarn)
-
Clone the repository:
git clone https://github.com/dhruvaparnathi/Mac-OS.git cd Mac-OS -
Install dependencies:
npm install
-
Start the development server:
npm run dev
Open
http://localhost:5173in your browser. -
Build for production:
npm run build
-
Lint and code quality check:
npm run lint
Dhruv Aparnathi
MERN Stack & Full-Stack Engineer
B.Tech in Computer Science & Engineering โ Parul University (Expected 2027)
- ๐ Portfolio: macbook-os.netlify.app
- ๐ป GitHub: @dhruvaparnathi
- ๐ LinkedIn: dhruv-aparnathi
- โก Codolio: codolio.com/profile/dhruvaparnathi
- ๐ง Email: dhruv.aparnathi.1@gmail.com
- ๐ฑ Phone: +91 8200733252
This project is licensed under the MIT License โ feel free to use it for personal inspiration or portfolio learning.



