// Check the health of the running WealthWise API, web app, and MongoDB services. Triggers when asked to "check if the app is running", "verify the API is up", "is the server healthy", or "show service status".
| name | health-check |
| description | Check the health of the running WealthWise API, web app, and MongoDB services. Triggers when asked to "check if the app is running", "verify the API is up", "is the server healthy", or "show service status". |
Check the health of the running WealthWise services.
curl -sf http://localhost:4000/api/health
Expected: HTTP 200 with { "status": "ok" }.
curl -sf -o /dev/null -w "%{http_code}" http://localhost:3000/
Expected: HTTP 200.
# Try Docker first
docker compose ps 2>/dev/null
# If Docker is not available, try Podman
podman ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" 2>/dev/null
The API health endpoint reflects DB connectivity. HTTP 503 from the health endpoint typically means MongoDB is unreachable.
Service Status Notes
─────────────────────────────────────────
API (port 4000) ✓ up | ✗ unreachable
Web (port 3000) ✓ up | ✗ unreachable
MongoDB ✓ connected | ✗ disconnected (via API health)
Docker/Podman ✓ running X/N containers | ✗ daemon not running
If a service is down:
docker compose ps or podman psdocker compose logs --tail=30 <service> or podman logs --tail=30 <container>$docker-upExecute the Flywheel bead lifecycle — find, claim, implement, review, close
Manage the WealthWise Docker/Podman Compose development environment. Triggers when asked to "start Docker", "start Podman", "bring up the containers", "stop Docker", "show Docker logs", or "restart the dev environment". Does NOT trigger implicitly.
Scaffold a complete new API endpoint for the WealthWise Express API. Triggers when asked to "add an endpoint", "create a route", "build an API for <entity>", or scaffold any new REST resource end-to-end. Does not trigger for frontend-only tasks.
Seed the WealthWise MongoDB database with categories or demo data. Triggers when asked to "seed the database", "add demo data", "populate categories", or "set up test data". Does NOT trigger implicitly during general development tasks.
Scaffold a new Mongoose model and its CRUD service for the WealthWise API. Triggers when asked to "create a model", "add a Mongoose schema", or add the data layer for a new entity without a full endpoint. Does NOT scaffold routes, controllers, or frontend code. Use $api-endpoint for the full stack.
Scaffold a complete new Next.js dashboard page for the WealthWise web app. Triggers when asked to "add a page", "create a dashboard screen", "build a UI for <feature>", or scaffold any new frontend feature end-to-end. Does not trigger for API-only or backend tasks.