Architecture Overview

The G2 Elite platform uses a modern edge-first architecture built on Cloudflare's developer platform.

System Diagram

Request Flow

Key Components

Component	Technology	Purpose
Gateway Worker	Cloudflare Workers + Hono	Auth verification, org routing, rate limiting
Mobile BFF Worker	Cloudflare Workers + Hono	Mobile-optimized data endpoints
Webhook Worker	Cloudflare Workers + Hono	Clerk user sync (svix verified)
Core DB	Cloudflare D1 (SQLite)	Users, orgs, memberships, invites
Org DB	PostgreSQL (RDS/Neon)	Teams, players, games, schedules, chat
Auth	Clerk (auth only)	Sign-in, sessions, token management
Mobile App	Expo / React Native	iOS app with Clerk SDK

Key Design Decisions

1. Clerk for auth only — no Clerk Organizations. Org membership managed in D1.
2. D1 for core DB — co-located with Workers for near-zero latency lookups.
3. Org DB connection strings as Worker secrets — not stored in database.
4. Single org DB for beta — architecture supports multi-org later.
5. HTTP polling for chat — Durable Objects planned for real-time (post-beta).
6. ApiAdapter pattern — all 35 mobile screens route through new backend without code changes.

Deployed Services

Service	URL
Gateway	https://g2-elite-gateway.2pw.workers.dev
Mobile BFF	https://g2-elite-mobile-bff.2pw.workers.dev
Webhook	https://g2-elite-webhook.2pw.workers.dev
Help Center	https://g2-elite-help.pages.dev
Internal Docs	https://g2-elite-internal-docs.pages.dev