.agents/skills/docker-up/SKILL.md
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.
npx skillsauth add hoangsonww/WealthWise-Finance-Tracker docker-upInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Manage the WealthWise container development environment (Docker or Podman).
Detect which container runtime is available:
docker info 2>/dev/null | head -1 — if it succeeds, use docker composepodman info 2>/dev/null | head -1 — if it succeeds, use podman-composeDocker:
| Argument | Action | Command |
|----------|--------|---------|
| (none) or dev | Start dev environment | docker compose up --build -d |
| prod | Start production stack | docker compose -f docker-compose.prod.yml up --build -d |
| down | Stop containers (preserve data) | docker compose down |
| down --volumes | Stop + wipe all volumes (data destroyed) | docker compose down -v |
| logs | Tail all service logs | docker compose logs -f |
| logs api or logs web | Tail one service | docker compose logs -f <service> |
Podman:
| Argument | Action | Command |
|----------|--------|---------|
| (none) or dev | Start dev environment | podman-compose -f podman-compose.yml up --build -d |
| prod | Start production stack | podman-compose -f podman-compose.prod.yml up --build -d |
| down | Stop containers (preserve data) | podman-compose -f podman-compose.yml down |
| down --volumes | Stop + wipe all volumes (data destroyed) | podman-compose -f podman-compose.yml down -v |
| logs | Tail all service logs | podman-compose -f podman-compose.yml logs -f |
| logs api or logs web | Tail one service | podman-compose -f podman-compose.yml logs -f <service> |
Services and ports (dev):
api → port 4000web → port 3000mongodb → port 27017mcp → port 5100agentic-ai → port 5200.env exists in apps/api/: test -f apps/api/.env. Never read it..env exists in apps/web/: test -f apps/web/.env. Never read it.down --volumes wipes all MongoDB data. Always confirm with the user before running.
docker compose ps or podman psDocker:
docker-compose.yml — development (hot-reload, volume mounts)docker-compose.prod.yml — production (Nginx reverse proxy, production builds)docker-compose.production.yml — hardened production (healthchecks, resource limits)Podman:
podman-compose.yml — development (Containerfiles, fully-qualified image refs)podman-compose.prod.yml — production (healthchecks, resource limits, Nginx)development
Run the WealthWise test suite with coverage reporting and summarize the results. Triggers when asked to "run tests with coverage", "check test coverage", "show coverage report", or "how many tests pass". Can be scoped to api, web, or types.
testing
Run the full WealthWise pre-PR checklist and report a pass/fail for each gate. Triggers when asked to "run pre-PR checks", "check if this is ready to merge", "validate before opening a PR", or "run the full check". Does NOT trigger implicitly.
development
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.
development
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.