Dengtiel/rise-up-africa

# RiseUp Africa > Empowering marginalized African youth with verified access to post-secondary opportunities RiseUp Africa is a comprehensive platform that connects marginalized youth (Refugees, IDPs, Vulnerable, PWDs) with verified access to post-secondary education opportunities. The platform facilitates the connection between youth seeking opportunities and donors/organizations providing them. ## 🌟 Features - **Multi-role System**: Support for Youth, Donors, Admins, and Field Agents - **Verification Workflow**: Comprehensive document verification and field visit system - **Opportunity Management**: Post and manage educational opportunities - **Application Tracking**: Track applications from submission to selection - **Search & Discovery**: Advanced search for verified youth and opportunities - **Modern UI**: Beautiful, responsive interface built with Next.js and shadcn/ui ## 🏗️ Architecture This is a **monorepo** built with: - **Package Manager**: PNPM with workspaces - **Build System**: Turbo - **Frontend**: Next.js 15 (React 19) - **Backend**: Express.js (Node.js 20+) - **Database**: PostgreSQL with Prisma ORM - **UI Components**: shadcn/ui + Tailwind CSS ### Project Structure ``` rise-up-africa/ ├── apps/ │ ├── api/ # Express.js REST API │ └── web/ # Next.js web application ├── packages/ │ ├── ui/ # Shared UI components │ ├── eslint-config/ │ └── typescript-config/ ├── docker-compose.yml ├── Dockerfile.* └── package.json ``` ## 🚀 Quick Start ### Prerequisites - **Node.js** >= 20 - **PNPM** >= 10.4.1 - **PostgreSQL** >= 16 (or use Docker) - **Docker** & **Docker Compose** (optional, for containerized setup) ### Local Development Setup #### Option 1: Traditional Setup (Recommended for Development) 1. **Clone the repository** ```bash git clone cd rise-up-africa ``` 2. **Install dependencies** ```bash pnpm install ``` 3. **Set up environment variables** Create `.env` files: **`apps/api/.env`**: ```env DAT …