demo-app/README.md

demo-app

Minimal TypeScript microservice proving out the homelab CI/CD pipeline:

push to main
  -> Forgejo Actions (nholtware/workflows composite actions)
       checks:  npm ci + lint + test          (docker label)
       build:   docker build + push           -> git.lab.holtlabs.xyz/nholtware/demo-app:<sha>
       deploy:  kustomize edit set image      -> commit to nholtware/gitops
  -> ArgoCD syncs gitops -> k3s
  -> served by Traefik at Host: demo-app.k3s.local

Endpoints

• GET / — JSON with service name, git sha, pod hostname
• GET /healthz — liveness/readiness probe target

Local dev

npm ci
npm test
npm run build && npm start   # listens on :3000 (PORT to override)