veryextra-arg-site/README.md

VeryExtraOS-ARG

A retro pink XP-inspired ARG desktop experience built as a static web app.

It includes a fake desktop, draggable icons, window management, a virtual file explorer, Start menu actions, mock apps (Notepad/Paint/IE), and custom right-click context menus.

Repository

• GitHub: https://github.com/diontimmer/VeryExtraOS-ARG
• Local path: /home/diont/veryextra-arg-site

Tech stack

• HTML/CSS/Vanilla JavaScript
• Static assets served by nginx:alpine
• Docker Compose for local runtime

Project structure

• site/index.html — desktop shell, taskbar, start menu, window template
• site/script.js — all app logic (window manager, explorer, start actions, context menus)
• site/styles.css — global styles and retro UI styling
• site/fakeweb/ — in-world fake web pages and route index
• site/assets/audio/violin.mp3 — sample media asset
• ops/docker-compose.yml — nginx runtime config
• AGENTS.md — critical handoff notes for future sessions

Run locally

From the repo root:

docker compose -f ops/docker-compose.yml up -d

App will be available at:

• http://localhost:8008

Stop:

docker compose -f ops/docker-compose.yml down

Development workflow

No build step is required (static files).

Typical loop:

1. Edit files under site/
2. Refresh browser
3. Optional JS syntax check:

node --check /home/diont/veryextra-arg-site/site/script.js

If needed, redeploy container:

docker compose -f /home/diont/veryextra-arg-site/ops/docker-compose.yml up -d

Feature overview

Desktop and windows

• Draggable desktop icons with persisted layout
• Multi-window taskbar integration
• Show desktop toggle
• Minimize/close controls

Start menu

• Launches core apps (IE, Notepad, Paint, My Computer)
• Direct folder shortcuts (My Documents, My Pictures, Music)
• Mock system actions (Control Panel, Run, Help, Log Off, Turn Off)

Explorer and virtual filesystem

• My Computer-centered navigation model
• Back/Forward/Up icon nav buttons
• Quick Access sidebar for drives and key folders
• Openable text/image/audio virtual files
• Details panel for selected items

Right-click context menus

• Desktop icon context menu:
  • Open
  • Open All Selected
  • Reset Icon Layout
  • Properties
• Explorer item context menu:
  • Open
  • Open in New Window (folders)
  • Open Parent Folder (files)
  • Properties

Notes

• This is intentionally stylized and partially mock/simulated.
• Several system entries are stubs by design and can be expanded incrementally.
• Keep UX changes cohesive with the retro pink XP aesthetic.

Contributing guidelines

• Keep dependencies minimal unless explicitly requested.
• Prefer small, targeted changes to script.js and styles.css.
• Validate with node --check after JS edits.
• For handoff-critical updates, mirror them in AGENTS.md.

License

No license has been declared yet. Add one before making the repo public.