Skip to content

NasimReja077/macfolio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍎 Macfolio – macOS Inspired Web Desktop

A sleek and interactive macOS-style desktop experience built using React and modern frontend technologies. Macfolio transforms your browser into a fully functional desktop environment with draggable windows, a dock, and built-in applications.


🚀 Live Demo

👉 Add your live link here (Vercel / Netlify)


✨ Features

🖥️ Desktop Interface

  • macOS-inspired UI design
  • Smooth animations and transitions
  • Real desktop-like experience inside the browser

🪟 Window Management

  • Draggable and resizable windows
  • Multiple apps open simultaneously
  • Focus, minimize, and close controls

⚡ Dock System

  • Interactive app launcher
  • Active app indicators
  • Smooth hover effects

🧭 Top Menu Bar

  • Real-time clock
  • System status indicators
  • App-specific menus

💻 Built-in Applications

  • 🖥️ Terminal (CLI Emulator)
  • 📝 Notes (Markdown Editor)
  • 🧮 Calculator
  • 🎵 Spotify Integration
  • 🧑‍💻 GitHub Repository Viewer
  • 📄 Resume Viewer

🎨 Personalization

  • Dynamic wallpapers
  • Persistent settings using localStorage

🖱️ Advanced UI

  • Custom right-click context menu
  • Smooth animations (Framer Motion / GSAP)
  • Responsive interaction system

🛠️ Tech Stack

Layer Technology
Frontend React 19
Bundler Vite
Styling SCSS / TailwindCSS
Animations Framer Motion / GSAP
Window System react-rnd
Terminal react-console-emulator
Markdown react-markdown

📦 Installation

# Clone the repository
git clone https://github.com/NasimReja077/macfolio.git

# Navigate to project folder
cd macfolio

# Install dependencies
npm install

# Run development server
npm run dev

📁 Project Structure

src/
 ├── components/
 ├── apps/
 ├── hooks/
 ├── utils/
 ├── styles/
 └── pages/

🚧 Roadmap

  • File system simulation
  • Drag & drop support
  • Notification system
  • Multi-user profiles
  • PWA support
  • Mobile optimization

📸 Screenshots

(Add your project screenshots here)


🤝 Contributing

Contributions are welcome!

# Fork the repo
# Create a new branch
git checkout -b feature/new-feature

# Commit your changes
git commit -m "Add new feature"

# Push to GitHub
git push origin feature/new-feature

📜 License

This project is licensed under the MIT License.


👨‍💻 Author

Nasim Reja Mondal


⭐ Support

If you like this project, give it a ⭐ on GitHub!

About

A macOS-inspired interactive desktop environment built with React, featuring draggable windows, a functional dock, terminal, and built-in apps — all running in the browser.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors