A digital platform connecting farmers, aggregators, warehouses, logistics companies, processors, exporters, and international buyers across Africa — digitizing agricultural commodity trading from farm to export.
# GH Integrated Imperium (GH App)
> Connecting Farms. Creating Value. Feeding Nations.
A digital platform connecting farmers, aggregators, warehouses, logistics companies, processors, exporters, and international buyers across Africa — digitizing agricultural commodity trading from farm to export.
---
## 1. Project Status
**Current stage:** Pre-build → Demo Prototype
**Immediate goal:** A presentable landing page + clickable multi-role dashboard demo (mock data, no backend) for a stakeholder presentation.
**Long-term goal:** A fully functional production platform per the SRS (see `/docs/SRS.md` or the original spec).
| Stage | Description | Status |
|---|---|---|
| Demo Prototype | Static HTML/CSS/JS landing page mockup | 🔄 In progress |
| Phase 1–2 | React + Tailwind foundation, design system | ⬜ Not started |
| Phase 3–13 | Full feature build (see TODO.md) | ⬜ Not started |
| Phase 14–16 | Security, testing, deployment | ⬜ Not started |
Full task breakdown lives in **`TODO.md`** — that is the working checklist for the entire build, from tonight's demo through production launch.
---
## 2. What This Is
GH Integrated Imperium is a B2B/B2C agricultural commodity trading platform. It lets:
- **Farmers** list produce and see real-time commodity prices
- **Aggregators** source from multiple farmers and manage warehouse stock
- **Buyers / Exporters** browse the marketplace, place orders, and track export documentation
- **Logistics Companies** manage transport between farms, warehouses, and ports
- **Administrators** oversee the whole ecosystem via a dashboard
Core objectives (from the SRS):
1. Digitize agricultural commodity trading
2. Improve transparency and trust
3. Enable verified transactions
4. Simplify logistics and warehousing
5. Support export-ready documentation
6. Provide real-time commodity prices
---
## 3. Tech Stack
### Demo Prototype (tonight)
- Static HTML5 / CSS3 / vanilla JS
- No build step — opens directly in a browser
- Purpose: validat …