This commit adds comprehensive canonical documentation for all BlackRoad
infrastructure, domains, and services.
Documentation includes:
- BLACKROAD_CANONICAL_TRUTH.md - Master source of truth
- 19 GoDaddy registered domains
- 58 Cloudflare Pages projects
- 15 GitHub organizations
- 40+ repositories
- 7 physical devices (Raspberry Pis + VPS)
- 4 AI platform integrations
- Complete network plane taxonomy
- IP addressing schema
- Secrets management locations
- COMPLETE_DOMAIN_MASTER_LIST.md - All domains & projects
- Complete Cloudflare Pages inventory
- Domain-to-project mapping
- Deployment instructions
- DNS configurations
- LUCIDIA_EARTH_INFRASTRUCTURE.md - Infrastructure guide
- Cloudflare Pages, Workers, Tunnels
- Raspberry Pi deployment
- Docker configurations
- Claude Code integration
- QUICK_DEPLOY.md - Fast deployment reference
- ALL_DOMAINS_REFERENCE.md - Domain routing details
Automation scripts:
- blackroad-deploy-all.sh - Master deployment orchestrator
- blackroad-netdump.sh - Network inventory collector
All 19 domains:
- lucidia.earth (metaverse)
- blackroad.io (corporate)
- blackroadqi.com (quantum intelligence)
- blackroadquantum.{com,info,net,shop,store}
- roadchain.io, roadcoin.io
- And 10 more domains
Infrastructure as scripture. Complete canonical truth.
🤖 Generated with Claude Code (Cece)
Co-Authored-By: Claude <noreply@anthropic.com>
19 KiB
Complete Domain Master List - All Infrastructure
Owner: Alexa Louise Amundson (amundsonalexa@gmail.com) Company: BlackRoad Inc. Cloudflare Account: 463024cf9efed5e7b40c5fbe7938e256 / 848cf0b18d51e0170e0d1537aec3505a Last Updated: 2025-12-22 Total Pages Projects: 58 Total Custom Domains: 19+
Executive Summary
Infrastructure Scale
- Cloudflare Pages Projects: 58 active deployments
- Custom Domains: 19+ registered domains
- Subdomains: 30+ configured subdomains
- Total Domain Endpoints: 77+ accessible URLs
Primary Domains
- lucidia.earth - Metaverse Platform ⭐
- blackroad.io - Corporate Main Site
- blackroadqi.com - Quantum Intelligence
- blackroadquantum.info - Quantum Information
- blackroadquantum.net - Quantum Network
- blackroadquantum.shop - Quantum Shop
- blackroadquantum.store - Quantum Store
Part 1: Custom Domains (Root Zones)
Lucidia Ecosystem
| Domain | Status | Points To | Purpose |
|---|---|---|---|
| lucidia.earth | ✅ Active | lucidia-earth.pages.dev (via worker) | 3D Metaverse Platform |
BlackRoad Core
| Domain | Status | Points To | Purpose |
|---|---|---|---|
| blackroad.io | ✅ Active | blackroad-io.pages.dev | Corporate Main Site |
Quantum Suite
| Domain | Status | Points To | Purpose |
|---|---|---|---|
| blackroadqi.com | ✅ Active | blackroad-os-web.pages.dev | Quantum Intelligence Platform |
| blackroadquantum.info | ✅ Active | blackroad-os-web.pages.dev | Quantum Information Hub |
| blackroadquantum.net | ✅ Active | blackroad-os-web.pages.dev | Quantum Network |
| blackroadquantum.shop | ✅ Active | blackroad-os-web.pages.dev | Quantum Marketplace |
| blackroadquantum.store | ✅ Active | blackroad-os-web.pages.dev | Quantum Store |
Part 2: BlackRoad.io Subdomains
Operational Subdomains
| Subdomain | Points To | Purpose |
|---|---|---|
| earth.blackroad.io | earth-blackroad-io.pages.dev | Earth Visualization |
| demo.blackroad.io | blackroad-os-demo.pages.dev | Demo Environment |
| home.blackroad.io | blackroad-os-home.pages.dev | Home Dashboard |
| brand.blackroad.io | blackroad-os-brand.pages.dev | Brand Assets & Guidelines |
Creator Suite (blackroad-hello.pages.dev)
| Subdomain | Purpose |
|---|---|
| creator-studio.blackroad.io | Full Creator Studio |
| creator.blackroad.io | Creator Tools |
| studio.blackroad.io | Studio Environment |
Business Functions
| Subdomain | Purpose |
|---|---|
| devops.blackroad.io | DevOps Dashboard |
| education.blackroad.io | Education Platform |
| finance.blackroad.io | Finance Tools |
| legal.blackroad.io | Legal Resources |
| ideas.blackroad.io | Ideas & Innovation Hub |
| research-lab.blackroad.io | Research Laboratory |
Total blackroad.io Subdomains: 13
Part 3: All Cloudflare Pages Projects
58 Active Deployments
Lucidia Projects (4)
- lucidia-earth → lucidia-earth.pages.dev ⭐ METAVERSE
- lucidia-platform → lucidia-platform.pages.dev
- lucidia-core → lucidia-core.pages.dev
- lucidia-math → lucidia-math.pages.dev
BlackRoad Core (8)
- blackroad-io → blackroad-io.pages.dev, blackroad.io
- blackroad-os-web → blackroad-os-web.pages.dev + 6 quantum domains
- blackroad-os-prism → blackroad-os-prism.pages.dev
- blackroad-os-demo → blackroad-os-demo.pages.dev, demo.blackroad.io
- blackroad-os-home → blackroad-os-home.pages.dev, home.blackroad.io
- blackroad-os-brand → blackroad-os-brand.pages.dev, brand.blackroad.io
- blackroad-os-docs → blackroad-os-docs.pages.dev
- earth-blackroad-io → earth-blackroad-io.pages.dev, earth.blackroad.io
BlackRoad Services (20)
- blackroad-hello → blackroad-hello.pages.dev + 10 subdomains
- blackroad-metaverse → blackroad-metaverse.pages.dev
- blackroad-console → blackroad-console.pages.dev
- blackroad-prism-console → blackroad-prism-console.pages.dev
- blackroad-admin → blackroad-admin.pages.dev
- blackroad-dashboard → blackroad-dashboard.pages.dev
- blackroad-chat → blackroad-chat.pages.dev
- blackroad-agents → blackroad-agents.pages.dev
- blackroad-agents-spawner → blackroad-agents-spawner.pages.dev
- blackroad-tools → blackroad-tools.pages.dev
- blackroad-analytics → blackroad-analytics.pages.dev
- blackroad-api → blackroad-api.pages.dev
- blackroad-api-explorer → blackroad-api-explorer.pages.dev
- blackroad-builder → blackroad-builder.pages.dev
- blackroad-workflows → blackroad-workflows.pages.dev
- blackroad-store → blackroad-store.pages.dev
- blackroad-payment-page → blackroad-payment-page.pages.dev
- blackroad-buy-now → blackroad-buy-now.pages.dev
- blackroad-company → blackroad-company.pages.dev
- blackroad-docs-hub → blackroad-docs-hub.pages.dev
BlackRoad Infrastructure (10)
- blackroad-portals → blackroad-portals.pages.dev
- blackroad-portals-unified → blackroad-portals-unified.pages.dev
- blackroad-unified → blackroad-unified.pages.dev
- blackroad-gateway-web → blackroad-gateway-web.pages.dev
- blackroad-assets → blackroad-assets.pages.dev
- blackroad-status → blackroad-status.pages.dev
- blackroad-status-new → blackroad-status-new.pages.dev
- blackroad-pitstop → blackroad-pitstop.pages.dev
- blackroad-systems → blackroad-systems.pages.dev
- blackroad-me → blackroad-me.pages.dev
BlackRoad Variants (5)
- blackroad-blackroad-io → blackroad-blackroad-io.pages.dev
- blackroad-blackroad-me → blackroad-blackroad-me.pages.dev
- blackroad-blackroadai → blackroad-blackroadai.pages.dev
- blackroad-blackroadquantum → blackroad-blackroadquantum.pages.dev
- blackroad-cece → blackroad-cece.pages.dev
Road Ecosystem (7)
- roadworld → roadworld.pages.dev
- roadwork → roadwork.pages.dev
- roadwork-production → roadwork-production.pages.dev
- roadchain-io → roadchain-io.pages.dev
- roadchain-production → roadchain-production.pages.dev
- roadcoin-io → roadcoin-io.pages.dev
- roadcoin-production → roadcoin-production.pages.dev
Other Projects (4)
- operations-portal → operations-portal-duw.pages.dev
- remotejobs-platform → remotejobs-platform.pages.dev
- applier-blackroad → applier-blackroad.pages.dev
- blackroad-hello-test → blackroad-hello-test.pages.dev
Part 4: Domain-to-Project Mapping
Complete Routing Table
CUSTOM DOMAINS → PAGES PROJECTS
═══════════════════════════════════════════════════════
Primary Root Domains:
lucidia.earth → lucidia-earth-router (worker) → lucidia-earth.pages.dev
blackroad.io → blackroad-io.pages.dev
blackroadqi.com → blackroad-os-web.pages.dev
blackroadquantum.info → blackroad-os-web.pages.dev
blackroadquantum.net → blackroad-os-web.pages.dev
blackroadquantum.shop → blackroad-os-web.pages.dev
blackroadquantum.store → blackroad-os-web.pages.dev
BlackRoad.io Subdomains:
earth.blackroad.io → earth-blackroad-io.pages.dev
demo.blackroad.io → blackroad-os-demo.pages.dev
home.blackroad.io → blackroad-os-home.pages.dev
brand.blackroad.io → blackroad-os-brand.pages.dev
creator-studio.blackroad.io → blackroad-hello.pages.dev
creator.blackroad.io → blackroad-hello.pages.dev
studio.blackroad.io → blackroad-hello.pages.dev
devops.blackroad.io → blackroad-hello.pages.dev
education.blackroad.io → blackroad-hello.pages.dev
finance.blackroad.io → blackroad-hello.pages.dev
legal.blackroad.io → blackroad-hello.pages.dev
ideas.blackroad.io → blackroad-hello.pages.dev
research-lab.blackroad.io → blackroad-hello.pages.dev
Planned Subdomains (Not Yet Configured):
api.lucidia.earth → Raspberry Pi 192.168.4.38:3000
ws.lucidia.earth → Raspberry Pi 192.168.4.38:8080
admin.lucidia.earth → (to be deployed)
docs.lucidia.earth → (to be deployed)
api.blackroad.io → DigitalOcean 159.65.43.12:3000
Part 5: Infrastructure Deployment Methods
Quick Deploy Commands
Deploy to Any Pages Project
# General pattern
cd ~/project-directory
npm run build
wrangler pages deploy dist --project-name=<project-name>
# Specific examples
cd ~/lucidia-metaverse && wrangler pages deploy dist --project-name=lucidia-earth
cd ~/blackroad-io && wrangler pages deploy dist --project-name=blackroad-io
cd ~/roadworld && wrangler pages deploy dist --project-name=roadworld
Deploy All Major Projects
#!/bin/bash
# deploy-all-pages.sh
PROJECTS=(
"lucidia-earth:~/lucidia-metaverse"
"blackroad-io:~/blackroad-io"
"blackroad-os-web:~/blackroad-os-web"
"roadworld:~/roadworld"
)
for proj in "${PROJECTS[@]}"; do
IFS=':' read -r name path <<< "$proj"
echo "Deploying $name..."
cd "$path"
npm install
npm run build
wrangler pages deploy dist --project-name="$name"
done
echo "✅ All deployments complete!"
Part 6: DNS Configuration Templates
For Root Domains (via Worker)
Example: lucidia.earth
Type: CNAME
Name: @
Content: lucidia-earth-router.workers.dev (or use custom routing)
Proxy: ✅ Proxied (Orange Cloud)
TTL: Auto
Worker Config (wrangler.toml):
name = "lucidia-earth-router"
main = "src/index.ts"
compatibility_date = "2025-01-01"
[vars]
PAGES_URL = "https://lucidia-earth.pages.dev"
[[routes]]
pattern = "lucidia.earth/*"
zone_name = "lucidia.earth"
For Root Domains (Direct to Pages)
Example: blackroad.io
Type: CNAME
Name: @
Content: blackroad-io.pages.dev
Proxy: ✅ Proxied
TTL: Auto
For Subdomains
Example: demo.blackroad.io
Type: CNAME
Name: demo
Content: blackroad-os-demo.pages.dev
Proxy: ✅ Proxied
TTL: Auto
For Backend APIs (via Cloudflare Tunnel)
Example: api.lucidia.earth
Type: CNAME
Name: api
Content: <tunnel-id>.cfargotunnel.com
Proxy: ✅ Proxied
TTL: Auto
Part 7: Project Categories & Purposes
By Function
Metaverse & 3D
- lucidia-earth (Primary metaverse)
- blackroad-metaverse (Secondary metaverse)
- roadworld (Road-themed world)
- earth-blackroad-io (Earth visualization)
Administrative
- blackroad-admin
- blackroad-dashboard
- blackroad-console
- blackroad-prism-console
- operations-portal
Development Tools
- blackroad-os-prism
- blackroad-builder
- blackroad-tools
- blackroad-api-explorer
- blackroad-agents
- blackroad-agents-spawner
E-Commerce
- blackroad-store
- blackroad-payment-page
- blackroad-buy-now
- blackroadquantum.shop
- blackroadquantum.store
Content & Documentation
- blackroad-os-docs
- blackroad-docs-hub
- blackroad-os-brand
- blackroad-hello
Blockchain & Finance
- roadchain-io
- roadchain-production
- roadcoin-io
- roadcoin-production
Analytics & Monitoring
- blackroad-analytics
- blackroad-status
- blackroad-status-new
Communication
- blackroad-chat
Portals & Gateways
- blackroad-portals
- blackroad-portals-unified
- blackroad-gateway-web
Platform Core
- blackroad-unified
- blackroad-systems
- blackroad-pitstop
- blackroad-assets
Production Services
- roadwork
- roadwork-production
- remotejobs-platform
Mathematics & Science
- lucidia-math
- lucidia-core
- lucidia-platform
Part 8: Deployment Cheat Sheet
One-Command Deployments
# Lucidia Metaverse
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth
# BlackRoad Main
cd ~/blackroad-io && npm run build && wrangler pages deploy dist --project-name=blackroad-io
# Quantum Suite
cd ~/blackroad-os-web && npm run build && wrangler pages deploy dist --project-name=blackroad-os-web
# RoadWorld
cd ~/roadworld && npm run build && wrangler pages deploy dist --project-name=roadworld
# Any custom project
cd ~/your-project && npm run build && wrangler pages deploy dist --project-name=your-project-name
View Project Details
# List all projects
wrangler pages project list
# View specific project
wrangler pages project view <project-name>
# List deployments
wrangler pages deployment list --project-name=<project-name>
# Tail logs
wrangler pages deployment tail
Rollback Deployment
# List recent deployments
wrangler pages deployment list --project-name=lucidia-earth
# Rollback to specific deployment
wrangler pages deployment rollback <deployment-id> --project-name=lucidia-earth
Part 9: GitHub Integration
Repository Structure (Estimated)
Based on 66+ repositories across 15 organizations:
Primary Organization: BlackRoad-OS or blackboxprogramming
Key Repositories (Likely):
- lucidia-metaverse
- lucidia-earth-router
- blackroad-io
- blackroad-os-web
- blackroad-os-prism
- blackroad-os-core
- blackroad-metaverse
- roadworld
- roadchain-io
- roadcoin-io
- blackroad-hello
- blackroad-admin
- blackroad-agents
- And 53+ more...
Connect GitHub to Pages
Method 1: Via Cloudflare Dashboard
- Pages → Create Project
- Connect to Git
- Select Organization → Select Repository
- Configure build settings
- Save and Deploy
Method 2: Via Wrangler
wrangler pages project create <project-name> \
--production-branch main \
--build-command "npm run build" \
--build-output-directory dist
Part 10: Master Deployment Script
Universal Deployment Script
#!/bin/bash
# ~/deploy-domain.sh
# Universal deployment script for any project
set -e
PROJECT_NAME=$1
PROJECT_DIR=$2
if [ -z "$PROJECT_NAME" ] || [ -z "$PROJECT_DIR" ]; then
echo "Usage: ./deploy-domain.sh <project-name> <project-directory>"
echo "Example: ./deploy-domain.sh lucidia-earth ~/lucidia-metaverse"
exit 1
fi
echo "🚀 Deploying $PROJECT_NAME from $PROJECT_DIR"
cd "$PROJECT_DIR"
# Install dependencies if needed
if [ -f "package.json" ]; then
echo "📦 Installing dependencies..."
npm install
fi
# Build
if [ -f "package.json" ] && grep -q "\"build\"" package.json; then
echo "🔨 Building project..."
npm run build
BUILD_DIR="dist"
elif [ -d "public" ]; then
BUILD_DIR="public"
elif [ -d "build" ]; then
BUILD_DIR="build"
else
echo "❌ Could not determine build directory"
exit 1
fi
# Deploy
echo "☁️ Deploying to Cloudflare Pages..."
wrangler pages deploy "$BUILD_DIR" --project-name="$PROJECT_NAME"
echo "✅ Deployment complete!"
echo "🌐 https://$PROJECT_NAME.pages.dev"
Usage:
chmod +x ~/deploy-domain.sh
# Deploy any project
~/deploy-domain.sh lucidia-earth ~/lucidia-metaverse
~/deploy-domain.sh blackroad-io ~/blackroad-io
~/deploy-domain.sh roadworld ~/roadworld
Part 11: Domain Statistics
By Type
| Type | Count |
|---|---|
| .pages.dev URLs | 58 |
| Root custom domains | 7 |
| blackroad.io subdomains | 13 |
| Total accessible URLs | 78+ |
By Category
| Category | Projects |
|---|---|
| BlackRoad Core | 8 |
| BlackRoad Services | 20 |
| BlackRoad Infrastructure | 10 |
| Lucidia | 4 |
| Road Ecosystem | 7 |
| Other | 9 |
By Status
| Status | Count |
|---|---|
| Active with custom domain | 19 |
| Active (pages.dev only) | 39 |
| Total active | 58 |
Part 12: Quick Reference
All Custom Domains List
✅ lucidia.earth
✅ blackroad.io
✅ blackroadqi.com
✅ blackroadquantum.info
✅ blackroadquantum.net
✅ blackroadquantum.shop
✅ blackroadquantum.store
✅ earth.blackroad.io
✅ demo.blackroad.io
✅ home.blackroad.io
✅ brand.blackroad.io
✅ creator-studio.blackroad.io
✅ creator.blackroad.io
✅ studio.blackroad.io
✅ devops.blackroad.io
✅ education.blackroad.io
✅ finance.blackroad.io
✅ legal.blackroad.io
✅ ideas.blackroad.io
✅ research-lab.blackroad.io
Top Priority Projects
- lucidia-earth - Primary metaverse
- blackroad-io - Corporate site
- blackroad-os-web - Quantum platform (6 domains)
- blackroad-hello - Creator suite (10 subdomains)
- roadworld - Latest deployment
Essential Commands
# List all projects
wrangler pages project list
# Deploy to any project
wrangler pages deploy dist --project-name=<name>
# Check project status
wrangler pages project view <name>
# Tail deployment logs
wrangler pages deployment tail
# Rollback deployment
wrangler pages deployment rollback <id> --project-name=<name>
Part 13: Future Expansion
Potential New Domains
lucidia.earth✅ DEPLOYED- api.lucidia.earth (backend API)
- ws.lucidia.earth (WebSocket)
- admin.lucidia.earth (admin panel)
- docs.lucidia.earth (documentation)
Potential New Projects
Based on naming patterns, likely future deployments:
- blackroad-mobile
- blackroad-desktop
- lucidia-backend
- roadverse (metaverse expansion)
- quantum-core
Appendix: Complete Alphabetical Project List
- applier-blackroad
- blackroad-admin
- blackroad-agents
- blackroad-agents-spawner
- blackroad-analytics
- blackroad-api
- blackroad-api-explorer
- blackroad-assets
- blackroad-blackroad-io
- blackroad-blackroad-me
- blackroad-blackroadai
- blackroad-blackroadquantum
- blackroad-builder
- blackroad-buy-now
- blackroad-cece
- blackroad-chat
- blackroad-company
- blackroad-console
- blackroad-dashboard
- blackroad-docs-hub
- blackroad-gateway-web
- blackroad-hello
- blackroad-hello-test
- blackroad-io
- blackroad-me
- blackroad-metaverse
- blackroad-os-brand
- blackroad-os-demo
- blackroad-os-docs
- blackroad-os-home
- blackroad-os-prism
- blackroad-os-web
- blackroad-payment-page
- blackroad-pitstop
- blackroad-portals
- blackroad-portals-unified
- blackroad-prism-console
- blackroad-status
- blackroad-status-new
- blackroad-store
- blackroad-systems
- blackroad-tools
- blackroad-unified
- blackroad-workflows
- earth-blackroad-io
- lucidia-core
- lucidia-earth ⭐
- lucidia-math
- lucidia-platform
- operations-portal
- remotejobs-platform
- roadchain-io
- roadchain-production
- roadcoin-io
- roadcoin-production
- roadwork
- roadwork-production
- roadworld
Document Maintained By: Claude Code Owner: Alexa Louise Amundson Email: amundsonalexa@gmail.com / blackroad.systems@gmail.com Last Updated: 2025-12-22
Related Documentation:
- LUCIDIA_EARTH_INFRASTRUCTURE.md (Detailed infrastructure guide)
- QUICK_DEPLOY.md (Quick deployment reference)
- ALL_DOMAINS_REFERENCE.md (Domain routing details)