JosephNjorog/PitchLine

A cost-conscious, USSD-plus-PWA sports platform for grassroots participation, fan engagement, and monetization, built for the Africa's Talking Women in Tech Hackathon (Sports, Music and Entertainment theme). # PitchLine A cost-conscious, USSD-plus-PWA sports platform for grassroots participation, fan engagement, and monetization, built for the Africa's Talking Women in Tech Hackathon (Sports, Music and Entertainment theme). ## Table of contents - Overview - Architecture - Channel strategy - Core data model - Registration and account creation flow - Result submission and notification flow - Feature scope - Tech stack - Africa's Talking API usage - MVP build order - Monetization - Getting started - Environment variables - Roadmap ## Overview PitchLine solves a data and visibility gap in African grassroots sport: county leagues, school competitions, amateur clubs, and adaptive/para-sports programs generate real activity with no digital footprint. Existing sports tech targets the already-digitized professional tier; PitchLine targets the layer underneath, using USSD only where a data connection can't be assumed, and a PWA for everything that benefits from a richer, free-to-run interface. Full problem statement, solution narrative, feature list, and UI direction: see `PITCHLINE_PRODUCT.md`. ## Architecture ``` ┌─────────────────────────┐ ┌─────────────────────────┐ │ Team rep / coach │ │ Fan / sponsor / scout │ │ USSD or PWA register │ │ PWA: browse, follow, │ │ + submit results │ │ vote, pay │ └───────────┬─────────────┘ └────────────┬────────────┘ │ │ ▼ ▼ ┌───────────────────────────────────────────────────┐ │ Core API + database │ │ teams · fixtures · results · followers · votes │ │ sponsorships · accounts │ └───────────────┬───────────────────┬───────────────┘ │ │ ▼ ▼ ┌───────────────────┐ ┌──────────────────────┐ │ SMS (minimal) │ │ PWA (everything │ │ result alert + │ │ else) │ │ account-created …