Repository navigation
AppShelf v0.2.1
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:appfrom the package root; autopip 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.