🐚 Aqua Shell

Live Demo: alexlaroche.com

A browser‑based desktop & mobile live environment inspired by macOS and Linux.
Launch apps, manage windows, run a Unix‑like terminal, browse a virtual filesystem, and play built‑in games, all inside your browser.

Originally built as a simple portfolio project, I'm trying to expand it into a more OS‑in‑the‑browser experience.

✨ Features

• Window manager – drag, resize, maximise, close windows (works on desktop + mobile)
• Dock & Menubar – launch apps, see running indicators, responsive clock
• Terminal – Unix-style commands
• Virtual filesystem – shared between apps, editable, live updates
• Apps included:
  • File Manager – browse the virtual filesystem (grid/list view, preview pane)
  • Pong – classic arcade game with AI opponent
  • Terminal – full‑featured command line
  • Help – in‑OS documentation
• Responsive – works on desktop and touch devices (mobile‑optimised dock & navigation)

🛠 Tech Stack

• Vue 3
• TypeScript
• Vite
• CSS

🚀 Getting Started

Clone the repo and open it in VS Code:

git clone https://github.com/laroche-a/AquaShell.git

Or download the repo as a .zip, extract it, and open aqua_shell.sln

Launch Run and Debug (F5) in VS Code — it will start Vite automatically and open the app at http://localhost:5173. This should install node modules, if it doesn't run

npm install

in the terminal and try again.

Build for production — compiles and bundles the project into static HTML, JS, and CSS files in the dist/ folder:

npm run build