mrcharles
21b6f50613
validate-all.sh aborted after the very first check because its
post-increment counters (`((VAR++))`) return exit status 1 when the old
value is 0, and `set -e` terminated the script. Use arithmetic
assignment so the suite runs to completion.
Add a .shellcheckrc to suppress the SC1090/SC1091 warnings that are
inherent to the environment-driven design (dynamic `source` of demo.env),
and drop an unused variable in demo-test.sh, so every script passes
shellcheck cleanly.
💘 Generated with Crush
Assisted-by: Crush:glm-5.2
TSYS Developer Support Stack
A Docker Compose-based multi-service stack of FOSS applications that run locally on developer workstations to enhance productivity and quality of life.
What It Does
Deploys 24 services across 6 categories via a single command:
| Category | Services |
|---|---|
| Infrastructure | Homepage (dashboard), Pi-hole (DNS), Dockhand (Docker management), Docker Socket Proxy |
| Monitoring | InfluxDB (time series), Grafana (visualization), Metrics (GitHub metrics), Apple Health (health data) |
| Documentation | Draw.io (diagramming), Kroki (diagrams as code), Kiwix (offline wiki) |
| Developer Tools | Atomic Tracker, ArchiveBox, Tube Archivist, Wakapi, MailHog, Atuin |
| Productivity | Reactive Resume (resume builder), Resume Matcher (AI resume screening) |
Quick Start
cd demo
cp demo.env.template demo.env
./scripts/demo-stack.sh deploy
Access the dashboard at http://localhost:4000
Credentials: admin / demo_password (demo only)
Requirements
- Docker Engine + Docker Compose
- 8GB RAM minimum
- 10GB disk space
- Linux (tested on Ubuntu)
Documentation
| Document | Purpose |
|---|---|
| demo/PRD.md | Product requirements (the source of truth) |
| demo/README.md | Full deployment and service documentation |
| demo/AGENTS.md | Development guidelines |
| AGENTS.md | Quick reference for contributors |
Testing
# Unit tests (no Docker required)
bash demo/tests/unit/test_env_validation.sh
# Full test suite (requires running stack)
./demo/scripts/demo-test.sh full
License
See LICENSE.