mycashless Developer Docs

Welcome to the developer documentation home for the mycashless platform — the cashless payment stack powering events, venues, and personal accounts.

This site is the canonical entry point for anyone building against, integrating with, or operating the platform. It is hosted at dev2.mycashless.com and tracks the cashless-v2 branch of the parent monorepo.

---

Where to start

• Getting started

  Clone the monorepo, initialize submodules, and bring services up locally.

• Service catalog

  Every deployed host on dev2.mycashless.com and what runs behind it.

• API reference

  OpenAPI / Swagger pointers for every backend HTTP surface.

• Architecture

  Monorepo layout, service boundaries, payment integrations, deploy flow.

---

Platform at a glance

Layer	Stack
Backends	Python 3.12, Flask (legacy) → FastAPI (Phase 2), gunicorn/uvicorn
Frontends	Angular 21 + Bootstrap 5 + Material 21, Jest + Playwright
Mobile	Android (Kotlin/Compose + Java), iOS (Swift), shared Rust core via SDK
Shared SDK	cashless-core-rs (Rust + UniFFI → Kotlin / Swift)
Identity	Keycloak (identity) + Better Auth (sessions) + cashless-auth service
Datastore	MySQL 8.0 on Cloud SQL
Cache / queues	Redis
Payments	Stripe + Mercado Pago + Adyen + direct PayPal
Deploy	GitHub Actions → GHCR → ArgoCD → GKE (Helm)
Observability	OpenTelemetry → kube-prometheus-stack + browser SDK

---

Status

• Pre-launch. No version of cashless-v2 has shipped to production yet.
• Branch policy. All commits go directly to cashless-v2 on every repo. Feature branches and PR reviews resume after launch.
• Active milestone. Wave 6 closed on 2026-05-10 with KMP → Rust strangler-fig complete and the consolidated GCE Ingress live on dev2.mycashless.com.

For day-to-day cluster operations and the full deploy flow, see OPERATIONS.md in the parent monorepo.