BillMint — Sample Web App & API (PHP + JWT)

A minimal web API sample built for demonstration purposes.
It mirrors core logic from my production BillMint App, focusing on:

• JWT-based authentication
• GET/PUT workflow for business_profile
• Runnable with PHP’s built-in server
• Tiny browser client to test endpoints

This repo is meant to be:

• A job application code sample (simple, review-friendly).
• A portfolio piece showing clean API design in PHP.

---

🚀 Quick Start

1. Database

mysql -u root -p -e "CREATE DATABASE billmint_demo CHARACTER SET utf8mb4"
mysql -u root -p billmint_demo < server/sql/schema.sql

2. Configure

Edit server/public_html/config.php with your DB password (or leave empty if root has no password).

3. Run API

php -S 127.0.0.1:8080 -t server/public_html

Check health:

curl http://127.0.0.1:8080/healthz
# {"ok":true}

4. Demo Client

Open demo-web/index.html in a browser (or serve it):

npx http-server demo-web -p 9000

Visit: http://127.0.0.1:9000

• Dev Login → get JWT
• /me → test auth
• /business_profile → GET/PUT demo

---

🛠 Tech Stack

• Backend: PHP 8, MySQL, JWT
• Frontend Demo: Vanilla HTML/JS
• Auth: Simple dev login → JWT tokens
• Routing: Minimal index.php dispatcher

---

📌 Notes

• This is a trimmed-down sample (focused on auth + profile management).
• Production BillMint has many more endpoints (transactions, receipts, sync, etc.).
• Safe to run locally — no sensitive secrets included.

---

👤 Author

Francis Oyitoba
Portfolio · LinkedIn · GitHub