semamagambo-bit/virtual-school-uganda

# Virtual School Uganda - Modern EdTech Platform A world-class digital learning platform designed for Uganda with a focus on accessibility, scalability, and user engagement. ## 🎯 Vision "Learn Anywhere. Achieve Everywhere." - Uganda's modern digital learning experience. ## 🏗️ Architecture ### Frontend Stack - **Framework**: Next.js 14+ (App Router) - **Language**: TypeScript - **Styling**: Tailwind CSS + Shadcn UI - **State Management**: Zustand + React Query - **Animations**: Framer Motion - **Forms**: React Hook Form + Zod - **Charts**: Chart.js + Recharts - **PWA**: Next PWA ### Backend Stack - **Runtime**: NestJS - **API**: REST + GraphQL - **Database**: PostgreSQL - **Cache**: Redis - **Real-time**: WebSocket - **Auth**: JWT + OAuth2 + RBAC - **File Storage**: AWS S3 / GCP / Azure abstraction ### Deployment - **Containerization**: Docker - **Orchestration**: Kubernetes (optional) - **CI/CD**: GitHub Actions - **Monitoring**: ELK Stack / Datadog ## 📁 Project Structure ``` virtual-school-uganda/ ├── apps/ │ ├── frontend/ # Next.js web app │ ├── mobile/ # React Native (future) │ ├── backend/ # NestJS API │ └── admin/ # Admin dashboard ├── packages/ │ ├── ui/ # Shadcn components │ ├── types/ # TypeScript types │ ├── utils/ # Shared utilities │ └── database/ # Migrations + schemas ├── docs/ # Documentation ├── docker-compose.yml # Local development └── package.json # Monorepo root ``` ## 🚀 Getting Started ### Prerequisites - Node.js 18+ - PostgreSQL 15+ - Redis 7+ - Docker & Docker Compose ### Installation ```bash # Clone repository git clone github.com cd virtual-school-uganda # Install dependencies npm install # Setup environment variables cp apps/frontend/.env.example apps/frontend/.env.local cp apps/backend/.env.example apps/backend/.env # Start PostgreSQL & Redis …