macOS Desktop React Portfolio

A sleek, interactive macOS-inspired desktop environment built with React and Vite. This project simulates a desktop interface with draggable windows, a functional dock, and several built-in applications.

🚀 Features

• Window Management: Fully draggable and resizable windows powered by react-rnd.
• Functional Dock: Dynamic application launcher with active state indicators.
• Top Menu Bar: System status, real-time clock, and app-specific menus.
• Terminal (CLI): A functional terminal simulation for shell enthusiasts.
• Notes App: A markdown-enabled notes editor for quick thoughts.
• Calculator: A pixel-perfect macOS-style calculator.
• GitHub Integration: Showcase repositories and GitHub stats.
• Dynamic Wallpapers: Rotating background images for a fresh look.
• Context Menu: Custom right-click menu with desktop actions.

🛠️ Tech Stack

• React 19: Modern UI development.
• Vite 7: Fast build tool and dev server.
• SCSS: Advanced styling and layout.
• Libraries:
  • react-rnd: Window physics and management.
  • react-console-emulator: Powering the interactive terminal.
  • react-markdown: Rendering rich text in apps.

🏁 Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• npm or yarn

Installation

1. Clone the repository:

   git clone https://github.com/your-username/macos-desktop-react.git

2. Navigate to the project directory:

   cd macos-desktop-react

3. Install dependencies:

   npm install

4. Start the development server:

   npm run dev

📜 License

This project is open-source and available under the MIT License.