Skip to content

Overview

The Overview section is the architectural bible for how tomoda runs in production. Start here if you are new to the platform, evaluating a change that crosses several systems, or trying to understand why something is wired the way it is.

The four pages below cover the big picture, environment layout, the multi-cloud split, and the load-bearing architectural decisions that shape everything else in this repo.

  • Architecture

    Top-level production architecture. Cloudflare DNS, CloudFront CDN, GCP Load Balancer, Traefik ingress, in-cluster Postgres and Redis, Photon, and how ArgoCD reconciles it all from git.

  • Environments

    How dev and prod share a single GKE cluster, the namespace layout, and the app-of-apps bootstrap pattern that pulls everything else in.

  • Multi-Cloud

    What lives on GCP, what lives on AWS, and why Cloudflare is DNS-only. The full division of responsibility across three providers.

  • Decisions

    ADR-lite log of the choices that define the platform: GitOps, in-cluster data services, Traefik ingress, shared GCP project, spot nodes, and more.