BizPilot AI is a full-stack SaaS platform that gives African SMEs enterprise-grade tools:
# BizPilot AI π
### The AI-powered Business Operating System for African SMEs
> Built for Kenya and Africa. Powered by M-Pesa, WhatsApp, and Claude AI.
---
## π Overview
BizPilot AI is a full-stack SaaS platform that gives African SMEs enterprise-grade tools:
| Module | Features |
|--------|----------|
| π Dashboard | Real-time KPIs, animated charts, AI insights, activity feed |
| π POS | Fast checkout, receipt printing, M-Pesa + cash payments |
| π¦ Inventory | Multi-location stock, AI reorder alerts, barcode scanning |
| π± M-Pesa | STK Push, C2B, auto-reconciliation, transaction history |
| π Bookkeeping | Expense tracking, P&L, cash flow forecasting |
| π₯ CRM | Customer profiles, loyalty, debt tracking, churn prediction |
| π¬ WhatsApp | AI order bot (Swahili + English), auto-STK push |
| πΌ Payroll | PAYE/NSSF/NHIF auto-calc, M-Pesa disbursement |
| π Reports | PDF/Excel exports, interactive charts |
| π€ AI Assistant | Claude-powered business Q&A in Swahili/English |
---
## β‘ Tech Stack
```
Frontend β React 18 + Vite + TypeScript
Styling β Tailwind CSS + Framer Motion
UI β Shadcn/Radix UI primitives
Charts β Recharts
State β Zustand
Router β React Router v6
Backend β Supabase (PostgreSQL + Edge Functions)
Auth β Supabase Auth (email + OAuth)
AI β Claude (claude-sonnet-4) via Edge Function
Payments β Safaricom Daraja API (M-Pesa STK Push + C2B)
WhatsApp β Meta WhatsApp Business API
Deploy β Vercel (frontend) + Supabase (backend)
```
---
## π Quick Start
### 1. Clone & Install
```bash
git clone
github.com
cd bizpilot-ai
npm install
```
### 2. Configure Environment
```bash
cp .env.example .env
```
Fill in `.env`:
```env
VITE_SUPABASE_URL=
your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key
VITE_MPESA_ENV=sandbox
```
### 3. Setup Supabase Database
```bash
# Install Supabase CLI
npm install -g supabase
# Link your project
supabase link --project-ref your-project-ref
# β¦