All Projects
Beta2025Community Impact ยท AI/ML ยท SaaS

StokvelOS

Revolutionary Community Finance Platform for 11M South Africans

AI-powered stokvel management platform digitalizing South Africa's R50 billion informal savings economy. Built to serve 11 million South Africans in stokvels with automated record-keeping, contribution tracking, and fraud detection.

Serving

11M South Africans in stokvels

Market

R50B+ informal stokvel economy

Problem

95% of stokvels operate manually

Result

100% accuracy in automated tracking

The Problem

What needed solving

11 million South Africans participate in stokvels โ€” community savings groups โ€” but 95% operate manually with paper records, cash handling, and zero audit trails. This leads to disputes, fraud, and financial loss in communities that can least afford it.

The Solution

How I built it

A full-stack SaaS platform with AI-powered fraud detection, automated contribution tracking, member management, and digital financial records. Designed from the ground up for South African community structures.

Tech Stack & Decision Rationale
01

Next.js 14

App Router for SEO + SSR

02

TypeScript

Type safety for financial data

03

Supabase (PostgreSQL + RLS)

Row-Level Security for member privacy

04

OpenAI

AI fraud pattern detection

05

PayFast

South African payment gateway

06

Tailwind CSS

Rapid UI development

README.md โ€” stokvel-os
๐Ÿ“„ README.md
# StokvelOS
> Revolutionary Community Finance Platform for 11M South Africans

## Project Context
**Category:** Community Impact ยท AI/ML ยท SaaS
**Status:** Beta ยท 2025
**Author:** Nandawula Regine Kabali-Kagwa โ€” East London, South Africa

## Stack
```
Next.js 14                     # App Router for SEO + SSR
TypeScript                     # Type safety for financial data
Supabase (PostgreSQL + RLS)    # Row-Level Security for member privacy
OpenAI                         # AI fraud pattern detection
PayFast                        # South African payment gateway
Tailwind CSS                   # Rapid UI development
```

## Architecture Notes
- All data mutations validated server-side via Next.js API routes
- Row-Level Security enforced at database level (Supabase)
- Mobile-first, PWA-ready, offline-tolerant where connectivity is unreliable
- PayFast integration for ZAR-native payments (no USD conversion)
- SEO-optimised: metadata, JSON-LD, canonical URLs, sitemap

## Environment Variables
```env
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
OPENAI_API_KEY=
NEXT_PUBLIC_PAYFAST_MERCHANT_ID=
NEXT_PUBLIC_PAYFAST_MERCHANT_KEY=
RESEND_API_KEY=
```

## Links
- ๐ŸŒ Live:   Coming soon
- ๐Ÿ™ GitHub: Private repository
- ๐Ÿ—๏ธ Portfolio: https://creativelynanda.co.za/projects/stokvel-os

---
Built from East London, South Africa ยท 5th Industrial Revolution

Interested in similar work?

Let's discuss how I can build something like this for your business.

Let's Talk