Frontend for AfricaPEP — PEP screening UI for all 54 African countries
# AfricaPEP Frontend
The web frontend for AfricaPEP — an open-source African Politically Exposed Persons database for KYC/AML compliance.
**Live demo:** pep.patrickaiafrica.com | **Backend API:** api-pep.patrickaiafrica.com | **Backend repo:** AfricaPEP
## Features
- **Name Screening** — Fuzzy-match a name against 32,000+ African PEP profiles with match score breakdown
- **Batch Screening** — Screen up to 50 names in a single request
- **PEP Search** — Full-text search with filters (country, FATF tier, active status)
- **Country Coverage** — Browse all 54 African countries with per-country PEP counts
- **Statistics Dashboard** — Live stats on database coverage, tier distribution, and system health
## Pages
| Route | Description |
|-------|-------------|
| `/` | Home — single name screening |
| `/batch` | Batch screening (up to 50 names) |
| `/search` | Full-text PEP search with filters |
| `/countries` | Country coverage map |
| `/stats` | Database statistics and system health |
| `/pep/[id]` | Individual PEP profile (coming soon) |
## Quick Start
```bash
# 1. Clone
git clone
github.com
cd africapep-frontend
# 2. Install dependencies
npm install
# 3. Configure API URL
cp .env.local.example .env.local
# Edit .env.local with your backend URL
# 4. Run development server
npm run dev
# Open
localhost
```
## Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `NEXT_PUBLIC_API_URL` | `
api-pep.patrickaiafrica.com` | Backend API base URL |
| `NEXT_PUBLIC_API_KEY` | _(empty)_ | API key (required when backend has `API_KEY_ENABLED=true`) |
## Tech Stack
- **Framework:** Next.js 16 (App Router)
- **Language:** TypeScript 5
- **Styling:** Tailwind CSS 4
- **Deployment:** Vercel
## Project Structure
```
app/
├── page.tsx # Home — name screening
├── batch/page.tsx # Batch screening
├── search/page.tsx # PEP search with filters
├── c …