🖥️ SUDHI OS v3.0 - Virtual Desktop Portfolio

The Most Comprehensive Virtual Desktop Operating System Portfolio

Live Demo • Features • Documentation • Customize

🌟 Overview

SUDHI OS is a fully functional virtual desktop operating system built as a developer portfolio. It's not a mockup—every feature works, every window is draggable and resizable, every command executes, and every detail is pixel-perfect.

What Makes This Special

✨ 14 Fully Functional Applications
🎨 4 Real-time Switchable Themes
💻 35+ Working Terminal Commands
📊 12 Customizable JSON Data Files
🪟 Advanced Window Management (8-point resize)
🎮 7+ Hidden Easter Eggs
📱 100% Mobile Responsive
⚡ Optimized Performance (60fps animations)

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/yourusername/sudhi-os.git

# Navigate to project
cd sudhi-os

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Customization

Edit your info:

public/data/about.json      # Personal details
public/data/projects.json   # Portfolio projects
public/data/skills.json     # Skills & expertise

Refresh the page - Changes load automatically!
Deploy - Upload dist/index.html to any static host

🎯 Features

🖥️ Core Operating System

Feature	Description	Status
Boot Sequence	ASCII art + typewriter logs	✅
Matrix Rain	HTML5 Canvas digital rain	✅
CRT Effect	Scanline overlay	✅
Themes	4 color schemes	✅
Power States	Boot/Sleep/Shutdown/Restart	✅

🪟 Window Management

✅ Drag windows by title bar
✅ 8-point resize (corners + edges)
✅ Minimize/Maximize/Close
✅ Z-index stacking (click to focus)
✅ Edge snapping
✅ Smooth animations (Framer Motion)

💻 Applications (14 Total)

Productivity

📂 File Explorer - Navigate files
📋 Notepad - Text editor
📧 Email Client - Inbox management
📅 Calendar - Events & reminders

Development

_ Terminal - 35+ commands
⚙️ Settings - System config
📊 System Monitor - Performance
🔍 Process Manager - Task manager

Portfolio

👤 About - Personal profile
⚡ Skills - Animated bars
📁 Projects - Showcase
✉️ Contact - Form

Entertainment

🎵 Music Player - Playlists
🌍 Browser - Web simulation
🎨 Paint - Drawing tool
🎮 Games - Arcade

⌨️ Terminal Commands

View All 35+ Commands

System Info

help, about, neofetch, whoami, version
date, time, uptime, battery, wifi

Navigation

ls, pwd, cd, explorer [path]

Window Control

open [app], close [app], minimize [app]
settings, edit [file]

System

clear, clearall, history
restart, shutdown, sleep

Customization

theme [green|blue|amber|purple]
matrix on, matrix off

Utilities

echo [msg], calc [expr], find [file]
screenshot, record [start|stop]

Process

ps, kill [pid], top

Aliases

alias [name]="command"
unalias [name]

Portfolio

skills, projects, contact

Easter Eggs

sudo rm -rf /, hack, coffee, konami

📊 Data Files

All content is 100% customizable via JSON files in public/data/:

File	Purpose	Auto-loads
`about.json`	Personal info, bio, social links	✅
`projects.json`	Portfolio projects	✅
`skills.json`	Skills & proficiency levels	✅
`terminal-commands.json`	Custom terminal commands	✅
`settings.json`	System configuration	✅
`music-library.json`	Music playlists	✅
`browser-bookmarks.json`	Browser bookmarks	✅
`email-messages.json`	Email inbox	✅
`calendar-events.json`	Calendar events	✅
`games.json`	Game high scores	✅
`file-system.json`	Virtual file structure	✅
`paint-templates.json`	Paint canvas templates	✅

📖 Complete Data Guide

🎨 Themes

Switch themes in real-time via:

Settings Window - Visual theme selector
Start Menu - Theme submenu
Terminal - theme [name] command

Available themes:

🟢 Cyber Green (#00FF88) - Default hacker aesthetic
🔵 Neon Blue (#00BFFF) - Cool futuristic
🟡 Amber (#FFB300) - Warm retro
🟣 Purple (#BF00FF) - Cyberpunk vibrant

All UI elements (borders, glows, scrollbars, Matrix rain, etc.) update instantly!

⌨️ Keyboard Shortcuts

Shortcut	Action
`F`	Toggle fullscreen
`Escape`	Close window / Exit fullscreen
`Alt + T`	Open Terminal
`Alt + A`	Open About
`Alt + P`	Open Projects
`Alt + S`	Open Skills
`Alt + C`	Open Contact
`Alt + M`	Toggle Matrix Rain
`Alt + R`	Restart System
`Alt + E`	File Explorer
`Alt + D`	Text Editor

🐣 Easter Eggs

Hidden surprises throughout the OS:

Konami Code - Full-screen color flash
sudo rm -rf / - Snarky terminal response
hack - Fake hacking animation
coffee - ASCII coffee art
Logo × 5 clicks - Secret window
60s idle - Auto sleep mode
Hidden terminal responses - Try weird commands!

📱 Mobile Responsive

On screens < 768px, automatically switches to:

✅ Vertical scrolling layout
✅ Sticky navigation
✅ Touch-friendly buttons
✅ All content accessible
✅ Theme colors maintained

🔧 Technical Stack

Core

React 19.x - UI framework
TypeScript - Type safety
Vite 7.x - Build tool
Tailwind CSS - Utility-first CSS
Framer Motion - Animations

Features

HTML5 Canvas - Matrix rain effect
CSS Variables - Dynamic theming
LocalStorage - Data persistence
Context API - State management

Performance

Bundle: 471KB (135KB gzipped)
Animations: 60fps smooth
Components: Memoized for efficiency
Canvas: RequestAnimationFrame optimized

📈 Version History

v3.0 (Latest) - Major Feature Expansion

➕ Added 8 new applications
➕ Added 7 data configuration files
➕ Added 10+ terminal commands
➕ Added 8-point window resizing
➕ Total: 127+ features

v2.0 - Foundation

✅ Core OS with 6 applications
✅ Terminal with 25 commands
✅ Window management
✅ Theme system
✅ Total: 87 features

📖 Documentation

Complete Feature List - All 127+ features documented
What's New in v3.0 - Update highlights
Data Configuration Guide - JSON customization

🎯 Use Cases

Developer Portfolio

Replace About/Projects/Skills data with your own. Deploy as your personal site.

Interactive Resume

Showcase your work in a unique, memorable way that stands out.

Learning Project

Study advanced React patterns, window management, Canvas API, animations.

Design Inspiration

Reference for retro-futuristic, cyberpunk, hacker terminal aesthetics.

🚀 Deployment

Vercel (Recommended)

npm run build
vercel --prod

Netlify

npm run build
# Drag dist/index.html to Netlify

GitHub Pages

npm run build
# Copy dist/index.html to docs/ folder
# Enable Pages in repo settings

Any Static Host

Just upload dist/index.html - it's a single file!

🎨 Customization Examples

Change Your Name

// public/data/about.json
{
  "personal": {
    "name": "Your Name",
    "role": "Your Role"
  }
}

Add a Project

// public/data/projects.json
{
  "projects": [
    {
      "id": 7,
      "name": "My Awesome Project",
      "description": "What it does",
      "techStack": ["React", "Node.js"],
      "liveUrl": "https://demo.com",
      "repoUrl": "https://github.com/me/project"
    }
  ]
}

Add a Custom Terminal Command

// public/data/terminal-commands.json
{
  "customCommands": [
    {
      "command": "hire-me",
      "description": "Why you should hire me",
      "output": "I'm awesome because...",
      "action": "none"
    }
  ]
}

🏆 Achievements

✅ 127+ Features - Most comprehensive virtual OS portfolio
✅ 14 Applications - All fully functional
✅ 35+ Commands - Complete terminal experience
✅ 12 Data Files - Entirely customizable
✅ Zero Placeholders - Every feature implemented
✅ Production Ready - Build successful, optimized
✅ Mobile Responsive - Works on all devices
✅ Well Documented - Comprehensive guides included

🤝 Contributing

This is a portfolio template. Feel free to:

Fork and customize for your own portfolio
Study the code for learning
Suggest improvements via issues
Share your customized versions!

📄 License

MIT License - Free to use, modify, and distribute.

🙏 Credits

Built with:

React, TypeScript, Vite, Tailwind CSS, Framer Motion
Google Fonts: Orbitron + Share Tech Mono
Lucide Icons

Inspired by:

Windows 95 UI
Hacker terminals
Cyberpunk aesthetics
Retro-futuristic design

📞 Contact

Created by Sudhi - Full Stack Developer

🌐 Website: sudhi.dev
💼 LinkedIn: linkedin.com/in/sudhi
🐙 GitHub: github.com/sudhi
📧 Email: your@email.com

🌟 Show Your Support

If you like this project:

⭐ Star this repository
🍴 Fork and customize it
📢 Share with others
💬 Leave feedback

SUDHI OS v3.0

The Ultimate Virtual Desktop Portfolio

127+ Features • 14 Apps • 35+ Commands • 100% Customizable

Built with ❤️ using React, TypeScript & Vite

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
public/data		public/data
src		src
FEATURES.md		FEATURES.md
NEW_FEATURES_v3.md		NEW_FEATURES_v3.md
QUICK_START.md		QUICK_START.md
README.md		README.md
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Folders and files

Latest commit

History

Repository files navigation

🖥️ SUDHI OS v3.0 - Virtual Desktop Portfolio

🌟 Overview

What Makes This Special

🚀 Quick Start

Installation

Customization

🎯 Features

🖥️ Core Operating System

🪟 Window Management

💻 Applications (14 Total)

⌨️ Terminal Commands

📊 Data Files

🎨 Themes

⌨️ Keyboard Shortcuts

🐣 Easter Eggs

📱 Mobile Responsive

🔧 Technical Stack

Core

Features

Performance

📈 Version History

v3.0 (Latest) - Major Feature Expansion

v2.0 - Foundation

📖 Documentation

🎯 Use Cases

Developer Portfolio

Interactive Resume

Learning Project

Design Inspiration

🚀 Deployment

Vercel (Recommended)

Netlify

GitHub Pages

Any Static Host

🎨 Customization Examples

Change Your Name

Add a Project

Add a Custom Terminal Command

🏆 Achievements

🤝 Contributing

📄 License

🙏 Credits

📞 Contact

🌟 Show Your Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages