Skip to content

Latest commit

History

323 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

🖥️ Web-OS Portfolio — Interactive Developer Portfolio

A fully interactive Operating System-style portfolio hosted on GitHub Pages.
🌐 Live Demo:pravin-python.github.io/Web-OS-Portfolio

A real desktop OS experience in the browser — built with React, TypeScript, Zustand, and TailwindCSS v4. Drag windows, use the terminal, open apps, play games, and explore my work — all without a backend.


✨ Features

🗂️ Desktop Environment

  • Window Manager — Draggable, resizable, minimizable, maximizable windows with macOS-style traffic light buttons
  • Taskbar & Dock — Running apps shown in taskbar with minimize/restore support
  • System Tray — Clock, notifications, and quick-access menu
  • Right-click Context Menu — Desktop-level actions
  • Mobile Support — Responsive layout with mobile orientation guard and popup

📱 Installed Applications

AppRouteDescription
About Me/aboutDeveloper profile — skills, education, experience
Contact Center/contactEmail, LinkedIn, GitHub, social links
AI Predictor/ai-predictorML model-powered interactive predictions
AI Research Lab/model-logsModel experiments and training logs
Datasets/datasetsDataset viewer for ML experiments
DSA Lab/dsa-labInteractive Data Structures & Algorithms explorer with Python & Java code
ML Lab/ml-labMachine Learning learning lab — concepts, algorithms, visualizations
Security Toolkit/securityURL/phishing detection, hashing, encryption tools
Terminal/terminalIntegrated CLI with OS commands (ls, cd, run snake, help, etc.)
Files/filesVirtual file system explorer (JSON-based)
Notepad/notesLocal notepad with localStorage persistence
System Logs/system-logsReal-time OS event log viewer
Neural Snake/games/snakeCyberpunk snake game with neon visuals
TicTacToe AI/games/tictactoeMinimax algorithm AI opponent
Logic Grid 2048/games/2048Classic 2048 sliding puzzle
Trash/trashTrash bin for deleted virtual files

🛠️ Tech Stack

LayerTechnology
FrameworkReact 19 + TypeScript
Build ToolVite
State ManagementZustand
StylingTailwindCSS v4
RoutingReact Router v7 (BrowserRouter)
Window Interactionsreact-rnd
IconsLucide React + Custom SVGs
PersistencelocalStorage
HostingGitHub Pages

🌐 Live Deployment

URL:https://pravin-python.github.io/Web-OS-Portfolio

This app uses React Router BrowserRouter with clean paths (no #).
A custom public/404.html handles GitHub Pages SPA deep-link redirects, allowing direct URL access to any route like /about or /dsa-lab.


📦 Local Development

1. Clone

git clone https://github.com/pravin-python/Web-OS-Portfolio.git
cd Web-OS-Portfolio

2. Install

npm install

3. Run

npm run dev

App runs at: http://localhost:5173/Web-OS-Portfolio/


🚀 Build & Deploy

npm run build

Generates a dist/ folder. Deploy it to GitHub Pages with:

npm run deploy

Requires gh-pages and a deploy script in package.json.


📂 Project Structure

src/
├── apps/ # Individual applications (Terminal, Games, DSALab, MLLab, etc.)
├── core/ # OS core (appRegistry, appLauncher, state, device detection)
│ ├── appRegistry.ts # All app definitions & routes
│ ├── appLauncher.ts # App launch logic
│ └── state/ # Zustand stores (windows, notifications, etc.)
├── components/ # Shared UI components (Window, Taskbar, Dock, Tray, etc.)
├── layouts/ # DesktopLayout — wraps all apps in the OS shell
├── router/ # OSRouter — bridges URL changes to window management
├── hooks/ # Custom hooks (useDraggable, etc.)
└── data/ # Static JSON data (filesystem, projects, skills)
public/
├── svg/ # App icons (system/, apps/)
├── 404.html # GitHub Pages SPA redirect handler
├── manifest.json # PWA manifest
└── sitemap.xml # SEO sitemap

🔒 No Backend Required

This is a 100% frontend-only static application.

  • No server, no database, no API calls
  • All data served from static JSON files
  • State persisted via localStorage
  • Deployable on any static host (GitHub Pages, Vercel, Netlify)

👨‍💻 Author

Pravin Prajapati — Freelance Full-Stack Developer
Python · Java · AI Agent Development · Web Scraping · PHP eCommerce


📄 License

MIT License

About

Web-OS Portfolio is a production-grade, web-based operating system simulator that showcases your projects and skills through a desktop-like environment built entirely in the browser using React, TypeScript, Vite, and TailwindCSS.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages