A lightweight, cloud-ready software delivery management platform that unifies requirements, agile delivery, code management and manual and automated testing, issue/defect tracking, and release reporting. Built with TypeScript, Express, and AWS-first storage (DynamoDB + S3) with optional local JSON storage for quick starts.
- Unified test lifecycle: manage test cases, executions, issues, and defects in one place.
- Dual storage modes: local JSON for fast prototyping, or DynamoDB + S3 for cloud scale.
- REST API: 20+ endpoints with JWT auth, validation, rate limiting, and Prometheus metrics.
- Infrastructure as Code: Terraform modules for VPC, IAM, DynamoDB, S3, CloudWatch, ECS/Fargate, and API Gateway. Kubernetes manifests and Dockerfiles included.
- Docs as code: MkDocs + mike for versioned documentation (see
docs/andmkdocs.yml).
npm install
npm run build
npm start -- --helpTo run the API locally with JSON storage:
export USE_CLOUD_STORAGE=false
npm run dev
# API defaults to http://localhost:3000cd terraform
terraform init
terraform applyProvisioned components: VPC, DynamoDB table, S3 bucket, IAM roles, CloudWatch log group, ECS/Fargate service with ALB, API Gateway with VPC Link. Outputs include API endpoint and service URLs.
- API server: src/api-server.ts
- Cloud storage adapters: src/storage/
- Terraform IaC: terraform/
- Kubernetes manifests: k8s/
- Documentation: docs/ (MkDocs + mike), site config in mkdocs.yml
- Quick start: QUICKSTART_TYPESCRIPT.md
- Deployment: CLOUD_DEPLOYMENT_GUIDE.md and CLOUD_INFRASTRUCTURE_COMPLETE.md
- Architecture: ARCHITECTURE.md and DOCUMENTATION_INDEX.md
- Wiki versioning: docs/versioning.md
- Workflow: .github/workflows/gitops-delivery.yml
- What it validates per change:
- Lint/test/build for the TypeScript services
- Docs build (MkDocs + mike) to keep the wiki versionable
- Terraform fmt/validate for IaC sanity
- Outputs a run summary in GitHub Actions with test, docs, and IaC status.
Code - MIT
Docs - Creative Commons Attribution 4.0 International