Autonomous mission engine for building HBX national digital infrastructure. Open-core, Nigeria-first, world-customizable.
# 🔥 HBX-Forge
> Autonomous mission engine for building HBX national digital infrastructure.
> Open-core. Nigeria-first. World-customizable. Hack-proof by design.
---
## 🚀 What This Is
**HBX-Forge** is the build engine and mission control for the **HBX Platform** — a complete open-source stack for national digital infrastructure:
- 🆔 Identity & authentication
- 🏛️ Public-service portals
- 📚 Education systems
- 🏥 Health records
- 🏢 Business registration
- 🗺️ Land records
- 💰 Tax systems
- 📊 Project dashboards
- 📋 Open-data systems
- 🚨 Emergency communication
The Forge knows the entire roadmap, plans the work, spawns coding agents, tests, secures, deploys, and reports — autonomously with human approval gates at life-safety boundaries.
---
## ⭐ Star the Repo
Built from Lagos. Designed for the world. If this vision resonates, **give it a star** — it helps the right people find this work.
---
## 🏗️ Repository Structure
```
HBX-Forge/
├── apps/
│ ├── dashboard/ # Next.js mission control UI (deploys at /forge)
│ └── api/ # Orchestrator backend (the "brain")
├── packages/
│ ├── hbx-identity/ # HBX-ID: auth, MFA, OAuth/OIDC, biometric
│ ├── hbx-portal/ # Public-service portal framework
│ ├── hbx-audit/ # Tamper-proof audit logging
│ ├── hbx-crypto/ # Encryption stack (at-rest, in-transit, KMS)
│ ├── hbx-security/ # Threat models, scanners, compliance
│ └── hbx-i18n/ # Country profiles + localization
├── countries/
│ └── nigeria.yaml # Nigeria config: NIN, BVN, TIN, NDPR, languages
├── docs/
│ ├── ARCHITECTURE.md # Full system architecture
│ ├── THREAT-MODEL.md # Security threat model
│ ├── ROADMAP.md # Build sequence and milestones
│ └── GTM.md # Go-to-market and government sales playbook
├── deploy/
│ ├── netlify.toml # Dashboard deploy config
│ └── docker-compose.yml # Full stack for self-hosting
└── .github/
└── w …