Skip to main content
Real-time cricket scores delivered to iPhone lock screens via Live Activities. This is the internal reference for understanding how the system works — backend, iOS, and everything in between.

System Map

Understand the architecture at a glance.

System context

How backend, iOS, admin, and external services connect.

Layer architecture

Routes, services, repositories, and dependency injection.

Data model

DynamoDB tables, keys, GSIs, and access patterns.

Overview

Tech stack, project structure, and what this site covers.

Business Flows

How data moves across the system for each user story.

Live score → lock screen

Event-driven pipeline: Pollers → EventBus → Detectors → LACoordinator → APNs.

Live Activity lifecycle

Start, update, end — from user follow to lock screen dismissal.

Match following

User follows a match → push-to-start → Live Activity → updates → ends.

Authentication

Cognito signup, JWT validation, admin roles, follow sync.

Backend API

Endpoints, auth, background jobs, and config reference.

iOS App

SwiftUI architecture, Live Activities, services, and build setup.