Skip to content

AppShelf v0.1.0

Choose a tag to compare

@cspergel cspergel released this 11 Jun 03:05
· 41 commits to main since this release

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.