Repository navigation
AppShelf v0.2.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).
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 asapp.main:appfrom the package root, and auto-setspip 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.