Skip to content

pravin-python/Web-OS-Portfolio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

104 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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

App Route Description
About Me /about Developer profile β€” skills, education, experience
Contact Center /contact Email, LinkedIn, GitHub, social links
AI Predictor /ai-predictor ML model-powered interactive predictions
AI Research Lab /model-logs Model experiments and training logs
Datasets /datasets Dataset viewer for ML experiments
DSA Lab /dsa-lab Interactive Data Structures & Algorithms explorer with Python & Java code
ML Lab /ml-lab Machine Learning learning lab β€” concepts, algorithms, visualizations
Security Toolkit /security URL/phishing detection, hashing, encryption tools
Terminal /terminal Integrated CLI with OS commands (ls, cd, run snake, help, etc.)
Files /files Virtual file system explorer (JSON-based)
Notepad /notes Local notepad with localStorage persistence
System Logs /system-logs Real-time OS event log viewer
Neural Snake /games/snake Cyberpunk snake game with neon visuals
TicTacToe AI /games/tictactoe Minimax algorithm AI opponent
Logic Grid 2048 /games/2048 Classic 2048 sliding puzzle
Trash /trash Trash bin for deleted virtual files

πŸ› οΈ Tech Stack

Layer Technology
Framework React 19 + TypeScript
Build Tool Vite
State Management Zustand
Styling TailwindCSS v4
Routing React Router v7 (BrowserRouter)
Window Interactions react-rnd
Icons Lucide React + Custom SVGs
Persistence localStorage
Hosting GitHub 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

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors