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, integrating, 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.
Service status

Real-time health dashboard for all backend and frontend services.

Platform at a glance¶

Layer	Stack
Backends	Python 3.12, FastAPI on 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	`cashless-auth` (FastAPI) — password, phone OTP, Firebase, device, API key, MFA
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.

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