# StellarPayroll Africa
> Open-source payroll disbursement for African SMEs — built on the Stellar network.
---
## What is StellarPayroll Africa?
StellarPayroll Africa is an open-source payroll platform that lets African SMEs pay employees in local currencies (NGN, GHS, KES) or USDC — directly into mobile money wallets (M-Pesa, MTN MoMo, Airtel Money) or bank accounts — with near-zero fees and near-instant settlement.
It is built on top of the Stellar Disbursement Platform (SDP) and extended with payroll-specific logic: tax deduction engines, payslip generation, multi-sig approval workflows, and on-chain audit trails via Soroban smart contracts.
**Target markets:** Nigeria 🇳🇬 · Ghana 🇬🇭 · Kenya 🇰🇪
---
## Why StellarPayroll Africa?
| Problem | Traditional tools | StellarPayroll Africa |
|---|---|---|
| Transaction fees | 1.5–3.5% (Paystack, Flutterwave) | **This repo** (`payroll-africa-frontend`) is the `apps/dashboard` component — the Next.js employer dashboard.
---
## Features
### Employer Dashboard
- Organization setup and multi-tenant management
- Employee registry with CSV bulk upload
- Pay period creation and scheduling
- Gross-to-net payroll calculation with live deduction preview
- Multi-sig approval workflow (e.g. CEO + Finance must both approve)
- Real-time disbursement status tracking
- Payslip PDF download and email/SMS delivery
### Tax & Compliance Engine
Built-in deduction calculations for three countries:
**Nigeria** — PAYE (7–24%), Pension (8% employee / 10% employer), NHIS (1.75%), NHF (2.5%)
**Ghana** — PAYE (0–30%), SSNIT (5.5% employee / 13% employer), NHIL (2.5%)
**Kenya** — PAYE (KRA bands), NSSF (KES 200/mo), NHIF (KES 500–1,700/mo), Housing Levy (1.5%)
### Employee Onboarding (No smartphone required)
```
Employer uploads CSV
↓
SMS sent to employee:
"Your employer has sent your salary. Download the wallet app
or reply USSD to receive on M-Pesa. Code: 4829"
↓
Employee chooses:
A) Wallet app → SEP-24 flow → receives USDC
B …