Architecture Overview

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

How It All Connects

📱

Mobile App

Expo / React Native

💻

Web App

React / Vite

Authenticated requests

🛡️

API Gateway

Verifies identity • Finds your org • Routes requests

🗃️

Core Database

Users, orgs, memberships

⚡

Data Service

Teams, schedule, scores, chat

🔐

Clerk

Sign-in & account security

🏟️

Organization Database

All sports data — teams, players, games, schedules, chat & more

Client Apps

API Gateway

Services

Databases

External

What Happens When You Open the App

What happens when you open the app and view your teams

1

📱 App🛡️ Gateway

"Show me my teams"

2

🛡️ Gateway🔐 Clerk

Verify this person is who they say they are

3

🛡️ Gateway🗃️ Core DB

What org does this person belong to?

4

🗃️ Core DB🛡️ Gateway

Aaron — Admin at The Farm League

5

🛡️ Gateway⚡ Data Service

Get teams for The Farm League

6

⚡ Data Service🏟️ Org DB

Query teams, players, and schedule

7

🏟️ Org DB📱 App

Here are your teams with rosters and records

✅

Teams displayed in under 200ms

Key Components

Component	What It Does
API Gateway	Front door — verifies who you are and routes your request
Data Service	Fetches sports data and formats it for the mobile app
User Sync	Keeps user accounts in sync between Clerk and our database
Core Database	Knows users, organizations, and memberships
Org Database	Stores all the sports data (teams, players, games, etc.)
Clerk	Handles sign-in, passwords, and account security
Mobile App	The iOS app parents and coaches use

Where Everything Lives

Service	URL
API Gateway	g2-elite-gateway.2pw.workers.dev
Data Service	g2-elite-mobile-bff.2pw.workers.dev
User Sync	g2-elite-webhook.2pw.workers.dev
Help Center	g2-elite-help.pages.dev
Internal Docs	g2-elite-internal-docs.pages.dev