The conxius-platform repository is the central point of orchestration for the Conxian ecosystem. It manages services, environment secrets, and Docker-based local development.
For deep technical insights into the Conxian architecture, refer to the following authoritative documents:
- Whitepaper - Vision, ethos, and core Bitcoin sovereign finance layer.
- System Architecture Graph - Holistic organization-wide component mapping.
- Sovereign Computing Redesign (2026) - Paradigmatic shift to local-first, BFF-driven architecture.
- Alignment Strategy - Unified strategy for business logic, design, and authority.
- Ecosystem Synergy - Details on inter-repository workflows and the "Core Loop."
- Gap Analysis (GAPS.md) - Real-time tracking of Phase 6 implementation and technical debt.
- Fail-Closed BOS Payments + AP/AR Spec (CON-439) - Normative fail-closed control model including rail-by-rail finality controls for on-chain, ISO 20022, and PAPSS settlement.
- SIDL Release Readiness Runbook (CON-355) - Maintainer rollout and verification guidance for SIDL Frames, ElizaOS plugin actions, and x402 cart checkout reference flows.
Make it easy to run, compose, and deploy the Conxian stack (Gateway, UI, and operational services) with consistent local and CI environments.
Production-Ready (v0.2.1-aligned). The platform is fully aligned with Phase 6 sovereign primitives including AI Allocation, Universal Bitcoin Identity (UBI), and the Global Liquidity Mesh.
Ownership and review requirements are defined in CODEOWNERS.
- Platform engineers running the full stack locally or in hosted environments.
- Contributors who need a single entry point for wiring and dependency management.
- Operators validating observability, secrets, and deployment workflows.
- Declarative Control Plane: Defines and coordinates the core services (Gateway, UI, Admin) as a runnable system.
- Sovereign Primitives: Facilitates Phase 6 features including AI-Driven Asset Allocation, Universal Bitcoin Identity (UBI), and Nexus Glass Node synchronization.
- Market Readiness: Integrates ALEX Method B (sovereign custody) and Structured Finance (Ops Loans) capabilities.
- Deployment & Ops: Integrates deployment workflows (StacksOrbit/GCP/Render) and shared institutional libraries like
lib-conxian-core.
Ensure you have Docker and Git installed.
make init # Initialize and update all submodules
make auth # Provision .env with secure random secrets
make start # Build and start the entire stack
make bench # Run performance benchmarks- services/lib-conxian-core: Shared Rust/TS libraries and the Conxian Gateway.
- services/conxian-ui: The primary Next.js dashboard for users.
- services/admin-dashboard: Internal telemetry and system monitoring.
- services/admin-pulse-bos: Dev-only BOS pulse prototype (not production-wired).
- services/elizaos-plugin-conxian: ElizaOS plugin for Conxian Gateway and social interfaces.
- openspec/: Specifications for all system changes and Phase 5/6 alignment.
- docs/PRODUCTION_BOUNDARY.md: Owner surface + production boundary for BOS-related work in this repo.
- LICENSE (MIT)
- SECURITY.md - Vulnerability reporting process
- CONTRIBUTING.md - Monorepo development guidelines
- CODEOWNERS - Service-level ownership
This repository follows the OpenSpec First directive. All architectural changes must be proposed and reviewed within the openspec/ directory before implementation.
Conxian uses the Earthy Corporate Finance theme:
- Primary: Forest Green (#2E403B)
- Secondary: Gold (#D4A017)
| Repository | Classification | Role |
|---|---|---|
| Conxian/Conxian | Flagship | Master Orchestrator |
| conxius-platform | Control Plane | Declarative Control Plane |
| conxian-ui | Product UI | Institutional Dashboard |
| conxius-wallet | Sovereign Access | Mobile Secure Enclave |
| lib-conxian-core | Core SDK | Gateway & Primitives |
| conxian-nexus | Glass Node | State & Risk Oracle |
| admin-dashboard | Internal | Telemetry & Operations |
For full details, see REPOSITORY_TAXONOMY.