Build & deploy

Build script

The app is built using scripts/build-ios.sh, which handles configuration, SDK selection, and API URL injection.

# Usage
./scripts/build-ios.sh [Configuration] [SDK]

The script injects the correct API URL at build time based on the configuration and environment.

API sources

Environment	URL	Purpose
Production	`api.sightscreen.app`	Live production API
Fake	`fake-api.sightscreen.app`	Fake API for development and testing

URL resolution order

The API base URL is resolved in this priority order:

Build-time override

If an explicit API URL is passed to the build script, it takes priority.

SANDBOX_API_URL environment variable

If set, this env var overrides the default. Useful for pointing at local or staging servers.

Default

Falls back to the production URL (api.sightscreen.app).

To test against the fake API locally, set SANDBOX_API_URL=https://fake-api.sightscreen.app before building.

Info.plist configuration

Key entries in the app’s Info.plist:

Key	Value	Purpose
`NSSupportsLiveActivities`	`YES`	Enables Live Activity support
`NSSupportsLiveActivitiesFrequentUpdates`	`YES`	Allows more frequent APNs updates for Live Activities
`UIBackgroundModes`	`fetch`, `remote-notification`	Enables background fetch and push processing

All three Info.plist entries are required. fetch enables periodic stale-detection checks. remote-notification enables silent push processing for Live Activity token management. NSSupportsLiveActivitiesFrequentUpdates unlocks the higher update budget needed for ball-by-ball cricket scoring.

Bundle identifiers

Target	Bundle ID
Main app	`com.sightscreen.ios`
Widget	`com.sightscreen.ios.SightscreenWidget`

The main app bundle ID is registered with APNs for push notifications and Live Activity updates.

The widget target SightscreenWidget is a separate build target that shares models with the main app.

Shared resource	How
Generated models	All `.generated.swift` files included in both targets
Cached images	App group shared container (`ImageCacheService` writes, widget reads)
Constants	Shared constants file for match IDs, URLs, etc.

Fonts

The app uses two custom font families:

Font	Usage
Clash Display	Headings, scores, large display text
Satoshi	Body text, labels, secondary information

Both are bundled in the app and registered in Info.plist.

Theme system

Visual theming is managed through three files:

File	Purpose
`Colors.swift`	App-wide color definitions (background, text, accent, etc.)
`Typography.swift`	Font size and weight presets mapped to Clash Display and Satoshi
`TeamBranding.swift`	IPL team-specific colors (primary, secondary, gradient) for match cards and Live Activities

Example: TeamBranding lookup

struct TeamBranding {
    let primary: Color
    let secondary: Color
    let gradient: [Color]

    static func branding(for teamAbbr: String) -> TeamBranding {
        switch teamAbbr {
        case "MI": return TeamBranding(
            primary: .blue,
            secondary: .gold,
            gradient: [.blue, .darkBlue]
        )
        case "CSK": return TeamBranding(
            primary: .yellow,
            secondary: .blue,
            gradient: [.yellow, .darkYellow]
        )
        // ... other IPL teams
        default: return defaultBranding
        }
    }
}

Team branding colors are one of the few things defined on the client side, since they are purely visual and do not depend on match state or backend logic.

iOS App

Build script

API sources

URL resolution order

Info.plist configuration

Bundle identifiers

Widget target

Fonts

Theme system

​Build script

​API sources

​URL resolution order

​Info.plist configuration

​Bundle identifiers

​Widget target

​Fonts

​Theme system

Build script

API sources

URL resolution order

Info.plist configuration

Bundle identifiers

Widget target

Fonts

Theme system