tech stack.md

Tech Stack

All free/open-source. Total cost to launch: $0.

Last updated: 2026-04-30

---

Core Stack

Layer	Technology	Cost	Notes
CLI Tool	Python (Click library)	Free	Primary interface for v1
Backend API	Python (FastAPI)	Free	REST API for dashboard + integrations
Database	Supabase (PostgreSQL)	Free tier	Check history, audit logs
Frontend (Web)	Next.js or Vite	Free	Dashboard for check results + trends
Mobile App	Flutter	Free	iOS + Android deploy approval + alerts
Auth	Supabase Auth or Clerk	Free tier	OAuth with GitHub/GitLab
Hosting (MVP)	Railway or Fly.io	Free tier	Backend + dashboard hosting
CI/CD	GitHub Actions	Free (public repos)	Our own CI/CD + published actions
Payments	Stripe	Free until revenue	Subscription billing

Integrations (Read-Only)

Integration	Library/Method	Purpose
Kubernetes	kubernetes Python client	Config checks, resource verification
Trivy	CLI subprocess	Container vulnerability scanning
Checkov	CLI subprocess or Python API	IaC security scanning
JUnit XML	junitparser Python library	Test result parsing
GitHub Actions	Webhooks + API	CI/CD integration
GitLab CI	Webhooks + API	CI/CD integration
Slack	Slack SDK	Notifications, approvals
Status pages	HTTP requests	Dependency health checks

Architecture (MVP)

┌─────────────┐     ┌──────────────┐     ┌─────────────────┐
│  CLI Tool    │────▶│  FastAPI      │────▶│  Supabase       │
│  (Python)    │     │  Backend      │     │  (PostgreSQL)   │
└─────────────┘     └──────┬───────┘     └─────────────────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
     ┌────────▼──┐  ┌─────▼─────┐  ┌──▼──────────┐
     │  Web       │  │  Mobile   │  │  Slack Bot   │
     │  Dashboard │  │  App      │  │  (Alerts)    │
     │  (Next.js) │  │  (Flutter)│  └──────────────┘
     └───────────┘  └──────────┘

Design Decisions

1. Python for CLI + Backend — Team knows Python well, fastest path to MVP. Consider Go later for CLI performance.
2. FastAPI — Async, fast, auto-generates OpenAPI docs. Perfect for API-first product.
3. Supabase over self-hosted Postgres — Free tier, auth included, no ops overhead for MVP.
4. Flutter for mobile — Single codebase for iOS + Android. Umer's existing skill.
5. Next.js for dashboard — Could also be Flutter Web for code reuse. Decision deferred to Week 1.

See also

• Product Concept — Features this stack enables
• MVP Roadmap — Build timeline