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 " β¦