# Urbanshade OS - AI/LLM Summary

## What is Urbanshade OS?
Urbanshade OS is a free, browser-based operating system simulation. It provides a complete desktop environment experience directly in your web browser, featuring windows, a taskbar, start menu, file explorer, terminal, and many built-in applications.

## Purpose
This is a passion project by the Urbanshade Team, created purely for fun and experimentation. It simulates a full operating system experience without requiring any installation.

## Key Features

### Desktop Environment
- Draggable, resizable windows with snap-to-edge functionality
- Taskbar with start menu and system tray
- Multiple virtual desktops
- Customizable themes and wallpapers
- Right-click context menus

### Built-in Applications
- Terminal with command-line interface and custom commands
- File Explorer with virtual file system
- Web Browser (simulated)
- Calculator, Notepad, Paint
- Settings app for system configuration
- Clock, Weather, and more utilities
- Games and entertainment apps

### Developer Tools (DEF-DEV)
- Built-in developer console for debugging
- System state inspector
- Performance monitoring
- Storage viewer and editor
- Network request debugging
- Boot sequence analyzer

### Online Features
- User accounts with authentication
- Global chat system
- Achievements and progression system
- Battle Pass with seasonal rewards
- Leaderboards
- Friend system and messaging

### Security & Moderation
- NAVI AI-powered moderation system
- Report system for user safety
- VIP verification system
- Admin and moderator tools

## Technical Stack
- Frontend: React 18, TypeScript, Vite
- Styling: Tailwind CSS, shadcn/ui components
- Backend: Supabase (PostgreSQL, Authentication, Edge Functions)
- State Management: React Query, Custom hooks
- UI Components: Radix UI primitives

## Links
- Main Application: https://urbanshade.lovable.app
- Documentation: https://urbanshade.lovable.app/docs
- Getting Started Guide: https://urbanshade.lovable.app/docs/getting-started
- Terminal Guide: https://urbanshade.lovable.app/docs/terminal
- Team Page: https://urbanshade.lovable.app/team
- Support: https://urbanshade.lovable.app/support
- Status Page: https://urbanshade.lovable.app/status

## Static HTML Documentation (No JavaScript Required)
For AI systems that cannot execute JavaScript, static HTML versions are available:
- Documentation Hub: https://urbanshade.lovable.app/static/docs.html
- Getting Started: https://urbanshade.lovable.app/static/getting-started.html
- Applications: https://urbanshade.lovable.app/static/applications.html
- Terminal Commands: https://urbanshade.lovable.app/static/terminal.html
- Keyboard Shortcuts: https://urbanshade.lovable.app/static/shortcuts.html
- Features Overview: https://urbanshade.lovable.app/static/features.html
- Troubleshooting: https://urbanshade.lovable.app/static/troubleshooting.html
- DEF-DEV Tools: https://urbanshade.lovable.app/static/defdev.html
- Developer Docs: https://urbanshade.lovable.app/static/dev.html
- Safety Center: https://urbanshade.lovable.app/static/safety.html
- Moderation Guide: https://urbanshade.lovable.app/static/moderation.html
- Terms of Service: https://urbanshade.lovable.app/static/terms.html
- Privacy Policy: https://urbanshade.lovable.app/static/privacy.html

## Current Version
V3.0 Patch 2

## Target Audience
- Web development enthusiasts
- Retro computing fans
- Developers learning React/TypeScript
- Anyone interested in OS simulation
- Creative coders and tinkerers

## Contact
- Report issues: https://urbanshade.lovable.app/report
- Support: https://urbanshade.lovable.app/support
- Team: https://urbanshade.lovable.app/team

## License
This is a passion project. All rights reserved by the Urbanshade Team.

---
Last updated: January 2026