Repository navigation
AppShelf v0.1.0
AppShelf is a personal, one-click launcher for your local web/prototype projects on Windows. Register a project once, then start its dev server and open the browser with a single click — or one CLI command. Like Spotlight for your own local apps.
Install
Download AppShelf.exe below and run it. It's self-contained — no .NET runtime needed — and lives in your system tray. Click + Add App to register your first project.
Windows 10/11 (x64). The download is ~155 MB because it bundles the .NET 8 runtime.
The binary is unsigned, so Windows SmartScreen may warn on first run — click More info → Run anyway. Or build it yourself from source (see the README).
Highlights
- One-click launch with live status — polls until the port is actually up (IPv4 and IPv6)
- Clean stop — kills the whole process tree and frees the port (no orphaned
node) - Project groups — backend + frontend as one card; Start-all brings the backend up first
- Port registry + Port Doctor — clash-free reserved ports, and find/kill zombie dev servers
- System tray + a full CLI (
add/list/launch/stop/rm/port/ports/doctor/open) - Auto-detects Vite, Next.js, CRA, Astro, SvelteKit, Angular, FastAPI, Flask, Streamlit, Gradio
- Hand-editable JSON config at
%APPDATA%/AppShelf/config.json— no database
See the README for full docs, and SECURITY.md for the trust model.
Known limitation: the global-hotkey Spotlight overlay isn't built yet — it's the next planned feature.