stackdeck 0.3.0

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "stackdeck",
+  "version": "0.3.0",
+  "description": "Your projects folder, as a control panel. Browser dashboard to start, stop, and organize local dev services — git-branch aware, zero dependencies.",
+  "license": "MIT",
+  "author": "beingmechon",
+  "bin": { "stackdeck": "bin/stackdeck.js" },
+  "main": "server.js",
+  "files": ["server.js", "index.html", "bin/", "scripts/"],
+  "scripts": {
+    "start": "node server.js"
+  },
+  "engines": { "node": ">=18.13" },
+  "os": ["darwin", "linux"],
+  "keywords": ["process-manager", "dev-server", "dashboard", "local-development", "git", "procfile", "hotel"],
+  "repository": { "type": "git", "url": "https://github.com/beingmechon/stackdeck" }
+}

package/scripts/demo.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# Spin up a self-contained demo board with fictional services — for README
+# screenshots, GIFs, and trying Stackdeck without touching your real config.
+#
+#   ./scripts/demo.sh          → http://localhost:9899 (isolated STACKDECK_HOME)
+#   ./scripts/demo.sh stop     → tear it down
+set -euo pipefail
+REPO="$(cd "$(dirname "$0")/.." && pwd)"
+DEMO="${STACKDECK_DEMO_DIR:-/tmp/stackdeck-demo}"
+PORT=9899
+
+if [ "${1:-}" = "stop" ]; then
+  pkill -f "STACKDECK_DEMO_MARK" 2>/dev/null || true
+  [ -n "$(lsof -tnP -iTCP:$PORT -sTCP:LISTEN 2>/dev/null)" ] && kill "$(lsof -tnP -iTCP:$PORT -sTCP:LISTEN)"
+  rm -rf "$DEMO"
+  echo "demo stopped and removed"
+  exit 0
+fi
+
+rm -rf "$DEMO"
+mkdir -p "$DEMO/home" "$DEMO/projects"
+
+# ── fictional repos so the Projects section has content ──────────────────
+mkrepo() { # name, extra-branch, kind
+  local d="$DEMO/projects/$1"
+  mkdir -p "$d"
+  cd "$d"
+  git init -q -b main
+  git config user.email demo@example.com && git config user.name demo
+  if [ "$3" = node ]; then
+    printf '{ "name": "%s", "scripts": { "dev": "node server.js" } }\n' "$1" > package.json
+  else
+    printf '[project]\nname = "%s"\n' "$1" > pyproject.toml
+    touch main.py
+  fi
+  git add -A && git commit -qm "init"
+  [ -n "$2" ] && git branch "$2"
+  cd - >/dev/null
+}
+mkrepo shopfront        feature/checkout-v2   node
+mkrepo orders-api       feature/rate-limits   node
+mkrepo email-worker     ""                    py
+mkrepo ml-recommender   experiment/embeddings py
+mkrepo mobile-app       ""                    node
+
+# ── demo services: real processes, fictional purpose ─────────────────────
+LOOP='STACKDECK_DEMO_MARK=1; while true; do'
+cat > "$DEMO/home/config.json" <<JSON
+{
+  "port": $PORT,
+  "projectRoots": ["$DEMO/projects"],
+  "groups": ["Shop", "Pipeline"],
+  "categoryOrder": ["Product", "Services", "Experiments"],
+  "projectCategories": {
+    "shopfront": "Product", "mobile-app": "Product",
+    "orders-api": "Services", "email-worker": "Services",
+    "ml-recommender": "Experiments"
+  },
+  "services": [
+    { "name": "shopfront", "dir": "$DEMO/projects/shopfront", "group": "Shop", "port": 7411,
+      "command": "python3 -m http.server \${PORT:-7411} --bind 127.0.0.1" },
+    { "name": "orders-api", "dir": "$DEMO/projects/orders-api", "group": "Shop", "port": 7412,
+      "dependsOn": ["session-cache"],
+      "command": "python3 -m http.server \${PORT:-7412} --bind 127.0.0.1" },
+    { "name": "session-cache", "dir": "$DEMO/projects/orders-api", "group": "Shop",
+      "command": "$LOOP echo \"GET session:\$RANDOM → hit (2ms)\"; sleep 3; done" },
+    { "name": "email-worker", "dir": "$DEMO/projects/email-worker", "group": "Pipeline", "restart": "on-failure",
+      "command": "$LOOP echo \"[worker] sent order confirmation #\$RANDOM\"; sleep 2; done" },
+    { "name": "search-indexer", "dir": "$DEMO/projects/ml-recommender", "group": "Pipeline",
+      "command": "$LOOP echo \"indexed \$((RANDOM % 90 + 10)) documents\"; sleep 4; done" }
+  ]
+}
+JSON
+
+# ── daemon + start everything ─────────────────────────────────────────────
+STACKDECK_HOME="$DEMO/home" STACKDECK_PORT=$PORT nohup node "$REPO/server.js" \
+  > "$DEMO/daemon.log" 2>&1 &
+for _ in $(seq 1 20); do
+  curl -sf -m 1 -o /dev/null "http://localhost:$PORT/api/ping" && break
+  sleep 0.5
+done
+TOKEN=$(cat "$DEMO/home/secret")
+H=(-H "X-Stackdeck-Token: $TOKEN" -H 'Content-Type: application/json')
+curl -s "${H[@]}" -X POST "http://localhost:$PORT/api/start-all" -d '{"group":"Shop"}' >/dev/null
+curl -s "${H[@]}" -X POST "http://localhost:$PORT/api/start-all" -d '{"group":"Pipeline"}' >/dev/null
+# one worktree instance for the money shot
+curl -s "${H[@]}" -X POST "http://localhost:$PORT/api/worktree/start" \
+  -d '{"name":"orders-api","branch":"feature/rate-limits"}' >/dev/null
+
+echo "demo board: http://localhost:$PORT"

package/scripts/macos-app.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+# Build ~/Applications/Stackdeck.app from this checkout (self-contained copy).
+set -euo pipefail
+REPO="$(cd "$(dirname "$0")/.." && pwd)"
+APP="$HOME/Applications/Stackdeck.app"
+
+mkdir -p "$APP/Contents/MacOS" "$APP/Contents/Resources"
+cp "$REPO/server.js" "$REPO/index.html" "$APP/Contents/Resources/"
+[ -f "$REPO/scripts/Stackdeck.icns" ] && cp "$REPO/scripts/Stackdeck.icns" "$APP/Contents/Resources/"
+
+cat > "$APP/Contents/Info.plist" <<'PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>            <string>Stackdeck</string>
+  <key>CFBundleDisplayName</key>     <string>Stackdeck</string>
+  <key>CFBundleIdentifier</key>      <string>dev.stackdeck.app</string>
+  <key>CFBundleVersion</key>         <string>0.1.0</string>
+  <key>CFBundlePackageType</key>     <string>APPL</string>
+  <key>CFBundleExecutable</key>      <string>Stackdeck</string>
+  <key>CFBundleIconFile</key>        <string>Stackdeck</string>
+  <key>LSUIElement</key>             <true/>
+</dict>
+</plist>
+PLIST
+
+cat > "$APP/Contents/MacOS/Stackdeck" <<'LAUNCH'
+#!/bin/bash
+# Finder launches apps with a bare PATH; resolve node via the user's shell.
+NODE="$(${SHELL:-/bin/zsh} -lc 'command -v node' 2>/dev/null || true)"
+[ -z "$NODE" ] && { osascript -e 'display alert "Stackdeck" message "node not found in PATH"'; exit 1; }
+RES="$(cd "$(dirname "$0")/../Resources" && pwd)"
+PORT="${STACKDECK_PORT:-8899}"
+if ! lsof -tnP -iTCP:$PORT -sTCP:LISTEN >/dev/null 2>&1; then
+  LOGDIR="${STACKDECK_HOME:-${XDG_CONFIG_HOME:-$HOME/.config}/stackdeck}/logs"
+  mkdir -p "$LOGDIR"
+  nohup "$NODE" "$RES/server.js" >> "$LOGDIR/daemon.log" 2>&1 &
+  for _ in $(seq 1 20); do
+    lsof -tnP -iTCP:$PORT -sTCP:LISTEN >/dev/null 2>&1 && break
+    sleep 0.25
+  done
+fi
+open "http://localhost:$PORT"
+LAUNCH
+chmod +x "$APP/Contents/MacOS/Stackdeck"
+echo "built $APP"