Repository navigation
What's New
Docker Multi-Environment Support (#43)
Every tstack create workspace now generates a complete Docker setup with three environments:
| Environment | Command | Purpose |
|---|---|---|
| Dev | ./start-dev.sh |
Hot-reload containers with source-mounted volumes |
| Test | ./start-test.sh |
Production images with test database |
| Prod | ./start-prod.sh |
Lightweight multi-stage alpine builds |
Key features:
- Host PostgreSQL by default -- services connect to your existing host databases (no duplication)
- Opt-in containerised PostgreSQL -- pass
--with-dbto spin up postgres:16-alpine alongside services - Dozzle log viewer -- real-time Docker logs at
http://localhost:9999in every environment - Non-Docker local dev -- workspace root
deno.jsonwithdeno task devusesconcurrentlyto run all services locally - Dockerfiles for all starters -- dev (hot reload) + production (multi-stage alpine) for API, Admin UI, and Storefront
Netdata Metrics Monitoring (#41)
Deployment guide now includes a Netdata section for self-hosted metrics monitoring -- same Dozzle-style single-container pattern at metrics.example.com.
Files Generated Per Workspace
my-shop/
├── docker-compose.dev.yml # Hot-reload dev containers
├── docker-compose.test.yml # Production images + test DB
├── docker-compose.yml # Production images + prod DB
├── start-dev.sh # ./start-dev.sh [--with-db]
├── start-test.sh # ./start-test.sh [--with-db]
├── start-prod.sh # ./start-prod.sh [--with-db]
├── stop.sh # Stop all Docker services
└── deno.json # deno task dev (no Docker)
Port Allocation
| Service | Dev | Test/Prod |
|---|---|---|
| API | 8000 | 8000 |
| Admin UI | 5173 | 3001 |
| Storefront | 5174 | 3002 |
| Status | 8001 | 8001 |
| Dozzle | 9999 | 9999 |
| PostgreSQL (--with-db) | 5432 | 5432 (5433 for test) |
Full Changelog: v1.6.3...v1.6.4