Skip to content

AppShelf v0.2.1

Choose a tag to compare

@cspergel cspergel released this 12 Jun 16:19
· 31 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.1

  • Spotlight: groups are one entry. A project group now shows as a single result (Enter or click starts the whole group, backend → frontend; opens the frontend if it's already running) instead of its members scattered as separate rows — and it still matches when you type a member's name or tag.
  • Spotlight: click to launch. Result rows now activate on a single mouse click, not just Enter.

From 0.2.0

  • Spotlight overlay — global-hotkey launcher: press your shortcut anywhere, type to fuzzy-match, Enter/click to launch. Also on the tray menu as "Search…".
  • Configurable hotkey — pick your own combo (tray → Hotkey…); defaults to Alt+Space → Ctrl+Alt+Space.
  • Launch pre-flight + one-click Run setup — a plain-English reason when an app can't start, plus a button that runs your install command and retries.
  • Rename a group from the GUI.
  • Smarter, package-aware stack detection (python -m uvicorn app.main:app from the package root; auto pip install -r requirements.txt).

Core features

  • 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.