BlackRoad Site Architecture

Complete page-by-page flow mapping for @blackboxprogramming's ecosystem

Tier 1: Consumer Hub
Tier 2: B2B Services
Tier 3: Developer Portal
Tier 4: Blockchain
Tier 5: AI Ecosystem
Tier 6: Personal Brand
blackroad.io Main Hub

The single entry point. "If you don't know where to start, start here."

  • / — Homepage (pain points, solution, CTA)
  • /create — Creator Portal entry
  • /create/video — RoadView Studio
  • /create/code — Lucidia IDE
  • /create/games — RoadEngine
  • /build — Business Portal
  • /learn — Education Portal
  • /learn/research — Research Hub
  • /tools/prism — Prism Console
  • /pricing — All products
Users: Everyone — creators, developers, learners, businesses
blackroadinc.us B2B

Professional services, consulting, and the Ops Starter productized service.

  • / — B2B landing page
  • /services — Service overview
  • /services/ops-starter — $500 productized service
  • /services/consulting — Custom consulting
  • /services/enterprise — Enterprise partnerships
  • /case-studies — Client work
  • /book — Calendly embed
Users: Businesses, enterprises, developers with messy repos
blackroad.systems Developer

Documentation, API reference, SDK guides, OS architecture.

  • / — Developer landing
  • /docs — Documentation root
  • /docs/getting-started — Quick start
  • /docs/architecture — System design
  • /docs/agents — Agent documentation
  • /docs/packs — Pack system
  • /api — Interactive API explorer
  • /sdk — SDK downloads
  • /changelog — Release notes
  • /status — System status
Users: Developers, integrators, contributors
blackroad.network Blockchain

RoadChain infrastructure, RoadCoin, validator nodes.

  • / — Web3 landing
  • /roadchain — Chain documentation
  • /roadcoin — Token info
  • /validators — Run a node
  • /wallet — Wallet connection
  • /explorer — Block explorer
Users: Web3 users, validators, crypto enthusiasts
lucidia.earth AI Ecosystem

The Lucidia AI system — 1,000 unique agents project.

  • / — Agent ecosystem landing
  • /agents — Agent directory
  • /architecture — Technical deep dive
  • /community — Community hub
  • /contribute — Contribution guide
Users: AI researchers, agent developers, enthusiasts
lucidia.studio Creative AI

Creative tools powered by Lucidia agents.

  • / — Studio landing
  • /tools — Available creative tools
  • /gallery — Created works
Users: AI artists, creative technologists
blackroad.me Personal

Alexa's personal thought leadership and media page.

  • / — Personal landing
  • /about — Bio & background
  • /writing — Blog posts, papers
  • /speaking — Speaking topics
  • /press — Media coverage
  • /contact — Get in touch
Users: Media, investors, collaborators
blackroadquantum.com Research

Quantum computing research, theoretical frameworks.

  • / — Research landing
  • /papers — Published research
  • /frameworks — Mathematical frameworks
  • /simulations — Quantum sims
Users: Researchers, academics, quantum enthusiasts
aliceqi.com Edge AI

Alice (Pi 400) agent interface for edge AI.

  • / — Alice landing
  • /setup — Hardware setup guide
  • /api — Local API docs
Users: Hardware hackers, edge AI developers

Flow 1: New Visitor → Creator

A creator discovers BlackRoad and starts making content

blackroad.io/
→ clicks "Start Creating" →
/create
→ selects "Video" →
/create/video
→ clicks "Try Free" →
/login
→
/studio/video (app)

Flow 2: Developer → Ops Starter Client

A developer with messy repos finds the productized service

blackroad.io/
→ sees "Ops Starter" →
blackroadinc.us/
→
/services/ops-starter
→ sends email →
Intake → Sprint → Delivery

Flow 3: Researcher → Research Hub

Someone interested in the theoretical work and frameworks

blackroad.io/
→ clicks "Learn" →
/learn
→
/learn/research
→ downloads report →
API access request

Flow 4: Developer → OS Documentation

A developer wants to understand and contribute to the OS

blackroad.io/
→ clicks "Docs" →
blackroad.systems/
→
/docs/architecture
→
/docs/agents
→
github.com/BlackRoad-OS

Flow 5: Enterprise → Consulting

Enterprise discovers BlackRoad and books a call

blackroadinc.us/
→
/services
→ clicks "Book a Call" →
/book
→
Discovery call → Proposal

Flow 6: AI Enthusiast → Lucidia Ecosystem

Someone interested in the 1,000 agents project

blackroad.io/create/code
→ sees Lucidia →
lucidia.earth/
→
/agents
→
/architecture
→
/contribute
GitHub Org Primary Domain Purpose
BlackRoad-AI blackroad.io Main consumer product repos
BlackRoad-OS blackroad.systems Core OS infrastructure & documentation
BlackRoad-Ventures blackroadinc.us Business services & consulting
BlackRoad-Cloud blackroad.network Blockchain infrastructure
BlackRoad-Education blackroad.io/learn Education products & content
BlackRoad-Media blackroad.io/create/video Video tools & RoadView
BlackRoad-Interactive blackroad.io/create/games Game engine & RoadEngine
BlackRoad-Studio lucidia.studio Creative tools
BlackRoad-Labs blackroadquantum.com Quantum & research
BlackRoad-Foundation blackroad.io/learn/research Research publishing
BlackRoad-Security blackroad.network Security infrastructure
BlackRoad-Hardware lucidia.earth, aliceqi.com Edge & hardware AI
BlackRoad-Gov (future) Government contracts
BlackRoad-Archive (internal) Historical preservation
Blackbox-Enterprises (holding) Parent entity
Repo Powers Feature On Domain
blackroad-os-web Frontend application blackroad.io
blackroad-os-api-gateway All API calls blackroad.systems/api
blackroad-os-prism-console Prism dashboard blackroad.io/tools/prism
blackroad-os-agents Agent runtime All agent features
blackroad-os-core Core logic Everything
blackroad-os-brand Design system All domains
blackroad-os-docs Documentation blackroad.systems/docs
blackroad-os-infra Deployment config Internal
blackroad-os-operator Ops playbooks blackroadinc.us
blackroad-os-pack-research-lab Research tools blackroad.io/learn/research
blackroad-os-pack-education Learning features blackroad.io/learn
blackroad-os-pack-creator-studio Creator tools blackroad.io/create
blackroad-os-pack-finance Financial tools blackroadinc.us
blackroad-os-pack-legal Legal automation blackroad.io/build/legal
blackroad-os-pack-infra-devops DevOps tools blackroad.systems
blackroad-os-beacon Monitoring Status pages
blackroad-os-home Landing pages blackroad.io
blackroad-os-demo Demo instances Demos
blackroad-os-research Research code blackroad.io/learn/research
blackroad-os-api API definitions blackroad.systems/api

Phase 1

Revenue Generation (Now)

  • 1 blackroad.io/ — Main landing ✓
  • 2 blackroadinc.us/ops-starter
  • 3 blackroad.io/create

Phase 2

Developer Credibility (Week 2-3)

  • 4 blackroad.systems/
  • 5 blackroad.systems/docs
  • 6 blackroad.io/tools/prism

Phase 3

Full Product Suite (Week 4-6)

  • 7 /create/video — RoadView
  • 8 /create/code — Lucidia
  • 9 /learn — Education
  • 10 /learn/research

Phase 4

Ecosystem Expansion (Month 2)

  • 11 lucidia.earth/
  • 12 blackroad.network/
  • 13 blackroad.me/