Tax-compliant invoicing for South African sole traders. Built-in payments, SARS Section 20 compliant, zero-backend.
# Phepha 🇿🇦
### SARS-compliant invoices that get you paid.
A self-serve, browser-based tool that produces **SARS Section 20–compliant tax invoices and quotes** for South African sole traders — branded, with an embedded PayFast payment link — for a **one-time fee of R299**. No subscription. No backend.
**Status:** Local preview, verified working. Not deployed (per build guardrail).
---
## What's in this folder
```
projects/phepha/
├── README.md ← you are here
├── docs/
│ ├── BUSINESS_CASE.md ← the problem, market, proof it works (every claim sourced)
│ ├── GO_TO_MARKET.md ← how to get the first 100 customers, inbound-only
│ ├── BRAND_GUIDE.md ← name, colours, typography, voice
│ └── BUILD_LOG.md ← every decision made, with reasoning
└── app/ ← the product (the thing you run)
├── index.html ← marketing / landing page
├── generator.html ← the invoice/quote generator (the actual product)
├── assets/
│ ├── phepha-mark.svg ← logo mark
│ └── phepha-logo.svg ← logo lockup
└── vendor/
└── jspdf.umd.min.js ← PDF library (vendored, no CDN)
```
---
## Run it locally (verification ports per AGENTS.md: 3002 / 3010 / 8080)
```bash
cd projects/phepha/app
python3 -m http.server 3010
```
Then open:
- **Landing page:**
localhost
- **Generator (the product):**
localhost
No build step. No dependencies to install. No API keys needed at runtime. It's a static site.
---
## How to use the generator
1. Open `generator.html`.
2. Type your business name, VAT number (if registered), and address (saved in your browser — never sent anywhere).
3. Add your client and line items. VAT (15%) calculates itself.
4. Watch the live preview on the right — it's a real SARS-compliant tax invoice.
5. Click **Download PDF**. You get a branded, compliant PDF.
**To try Pro features** (PayFast links): scroll to the "Unlock Pro" box → click " …