Repository navigation
Home
tavlean edited this page Nov 5, 2026
·
12 revisions
DevServers wiki: non-obvious decisions only.
Each page covers one thing. Load the page you need; skip the rest.
- Spawn Flow: why the dashboard owns the entire spawn lifecycle, the state machine, where the toast lives, Start-vs-Restart detection, and installing missing dependencies before a start.
- Menu Bar: the unload-per-run lifecycle, snapshot cache, poke pattern, and why starts route through the dashboard.
- Start at Login: why the menu bar starts marked projects after a boot, once-per-boot detection, and where marked projects show.
- Paths: every user-supplied path must be canonicalized.
- Process Detection: how we know what's running; cross-platform port plan.
-
Spawn Primitives:
zsh -ilc, detached spawn, SIGKILL, kill-then-spawn order, argv-not-interpolation. -
Script Picker: how
pickDevScriptdecides which script to run. -
Framework Detection: two detection paths (live process vs
package.json) and the tag label/color styling. - Favicons: detection order, CORS/data-URI inlining, the two-tier (port + cwd) cache.
- Recents: LocalStorage layer, write points, favicon caching, passive migration.
- Shopify Integration: running-server detection, theme and app start support, the 9292 port fallback, and Shopify-specific follow-ups.
- Raycast Quirks: bugs and gotchas in Raycast itself, with workarounds.
- Portless: custom domain integration, and why a wrapped dev script needs the proxy already running.
- UI Conventions: shortcuts, panel ordering.
- Publishing: fork sync, publish, PR description, Greptile, ready for review, pulling the merge date back.