dev-server
管理 vacay-photo-map 的开发服务器。在启动、停止或检查 postgres、前端 (Vite) 或 API (Bun) 服务器的状态时使用。
📖 中文导读:管理 vacay-photo-map 的开发服务器。在启动、停止或检查 postgres、前端 (Vite) 或 API (Bun) 服务器的状态时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: dev-server description: Manage development servers for vacay-photo-map. Use when starting, stopping, or checking status of postgres, frontend (Vite), or API (Bun) servers. allowed-tools: Bash
Dev Server Manager
Manages the three dev services: PostgreSQL, Frontend (Vite), and API (Bun/Hono).
Quick Commands
Check Status
.claude/hooks/check-dev-status.sh
Start All Services
# Start postgres first (use the hook for proper wait)
.claude/hooks/start-dev.sh
# Or manually:
docker compose -p vacay-dev up -d postgres
# Wait for ready: docker compose -p vacay-dev exec -T postgres pg_isready -U vacay
# Start frontend and API (run in background)
pnpm dev &
pnpm dev:api &
Start Individual Services
# Postgres only
docker compose -p vacay-dev up -d postgres
# Frontend only (localhost:5173)
pnpm dev
# API only (localhost:4000)
pnpm dev:api
Stop All Services
.claude/hooks/cleanup-dev.sh
Stop Individual Services
# Stop frontend/API (matches the pnpm commands)
pkill -f "pnpm dev"
pkill -f "pnpm dev:api"
# Stop postgres
docker compose -p vacay-dev down
Service Details
| Service | Port | Command | Health Check |
|---|---|---|---|
| PostgreSQL | 5433 | docker compose -p vacay-dev up -d postgres |
docker compose -p vacay-dev ps |
| Frontend | 5173 | pnpm dev |
curl -s localhost:5173 |
| API | 4000 | pnpm dev:api |
curl -s localhost:4000 |
Dev Tunnel Mode
For mobile/WebAuthn testing via Cloudflare Tunnel:
- Frontend: https://photos-dev.joeczar.com
- API: https://photos-dev-api.joeczar.com
Same commands - tunnel is configured on server side.
Troubleshooting
Port already in use
# Find what's using the port
lsof -i :5173
lsof -i :4000
# Kill it
kill -9 <PID>
Orphaned processes
# Run cleanup script
.claude/hooks/cleanup-dev.sh
# Or manually
pkill -f "pnpm dev"
pkill -f "pnpm dev:api"
Database connection issues
# Check postgres logs
docker compose -p vacay-dev logs postgres
# Restart postgres
docker compose -p vacay-dev restart postgres