loag0/BOCRA-upgrade

A modernized redesign of the Botswana Communications Regulatory Authority (BOCRA) website, built as a hackathon submission. # BOCRA Connect ### Unified Regulatory Services Platform **Botswana Communications Regulatory Authority** Live Demo · Documentation · Report Bug · Request Feature --- ## Overview BOCRA Connect is a modern, unified digital platform that transforms regulatory service delivery for the Botswana Communications Regulatory Authority. It replaces five disconnected legacy portals with a single, authenticated, mobile-first experience — enabling citizens, operators, and BOCRA staff to access and manage regulatory services entirely online. Built as a submission for the **BOCRA Digital Transformation Hackathon**, the platform directly addresses the Authority's mandate under the **Communications Regulatory Authority Act 2012** and aligns with the **Botswana Data Protection Act 2024**. ``` Before BOCRA Connect After BOCRA Connect ───────────────────── ──────────────────────────────── 5 disconnected portals → One unified platform, one URL No complaint tracking → Case reference + live status Manual licence lookup → Instant public verification API No citizen accounts → Self-service authenticated portal Staff-intermediated → End-to-end digital workflows No mobile support → Mobile-first, WCAG 2.2 compliant ``` --- ## Table of Contents - Motivation - Research - Features - Architecture - Tech Stack - Getting Started - Project Structure - Pages & Routes - Environment Variables - Deployment - Accessibility - Lessons Learned - Roadmap - References - License --- ## Motivation Botswana's communications sector is growing rapidly, yet citizens and licensed operators have historically faced a fragmented, manual-first experience when interacting with BOCRA. Regulatory services — complaint lodging, licence verification, document access — were spread across five disconnected portals, required staff intermediation for routine tasks, and offered no digital status tracking. For a regulator whose mandate spans telecommu …