Skip to content

AppShelf v0.2.0

Choose a tag to compare

@cspergel cspergel released this 12 Jun 03:27
· 33 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).

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). ~155 MB (bundles the .NET 8 runtime). Unsigned, so SmartScreen may warn on first run — click More info → Run anyway, or build from source.

What's new in 0.2.0

  • Spotlight overlay — a global-hotkey launcher: press your shortcut anywhere, type to fuzzy-match an app, Enter to launch (or open if it's already running). Also on the tray menu as "Search…".
  • Configurable hotkey — pick your own combo (tray → Hotkey…) so it never collides with your other tools. Defaults to Alt+Space → Ctrl+Alt+Space.
  • Launch pre-flight + one-click Run setup — when an app can't start (missing folder, uninstalled deps, no node_modules), AppShelf shows a plain-English reason and a Run setup button that runs your install command and retries.
  • Rename a group from the GUI.
  • Smarter stack detection — uses python -m uvicorn/streamlit (no PATH assumptions) and is package-aware: a FastAPI/Flask app inside a package detects as app.main:app from the package root, and auto-sets pip install -r requirements.txt.

Highlights (carried over)

  • One-click launch with live IPv4/IPv6 status; clean stop that kills the whole process tree and frees the port
  • Project groups (backend + frontend as one card); favorites; search
  • Port registry + Port Doctor (classify and kill zombie dev-server ports)
  • System tray; full CLI (add / list / launch / stop / rm / port / ports / doctor / open)
  • Hand-editable JSON config — no database

See the README and SECURITY.md for details.

Note: this release also fixes a packaging bug where the core process/port files were missing from the source tree — the repo now builds cleanly from a fresh clone.