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