lucidia/lucidia-earth-router
9
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit — RoadCode import

Browse Source
This commit is contained in:
blackboxprogramming
2026-03-08 20:04:56 -05:00
commit a9ceaf6c41
9 changed files with 3888 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

576
ALL_DOMAINS_REFERENCE.md Normal file
View File

@@ -0,0 +1,576 @@
# Complete Domain Reference for All BlackRoad & Lucidia Infrastructure
**Owner:** Alexa Louise Amundson
**Organization:** BlackRoad Inc.
**Last Updated:** 2025-12-22
---
## Domain Summary
**Total Domains:** 16+ zones
**Total Cloudflare Pages Projects:** 50+
**Raspberry Pi Devices:** 4
**Cloud VPS:** 1 (DigitalOcean)
---
## Primary Domains
### Lucidia Ecosystem
| Domain | Zone ID | Pages Project | Purpose | Status |
|--------|---------|---------------|---------|--------|
| **lucidia.earth** | 848cf0b18d51e0170e0d1537aec3505a | lucidia-earth | Metaverse platform | ✅ Active |
**Subdomains:**
- `api.lucidia.earth` → Raspberry Pi 192.168.4.38:3000
- `ws.lucidia.earth` → Raspberry Pi 192.168.4.38:8080 (WebSocket)
- `admin.lucidia.earth` → lucidia-admin.pages.dev
- `docs.lucidia.earth` → lucidia-docs.pages.dev
- `dev.lucidia.earth` → lucidia-dev.pages.dev
**Related Pages Projects:**
- lucidia-earth.pages.dev (main metaverse)
- lucidia-platform.pages.dev
- lucidia-core.pages.dev
- lucidia-math.pages.dev
### BlackRoad Primary
| Domain | Zone ID | Pages Project | Purpose | Status |
|--------|---------|---------------|---------|--------|
| **blackroad.io** | TBD | blackroad-io | Corporate site | ✅ Active |
**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
- `api.blackroad.io` → DigitalOcean 159.65.43.12:3000
- `creator-studio.blackroad.io` → blackroad-hello.pages.dev
- `creator.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
- `ideas.blackroad.io` → blackroad-hello.pages.dev
- `legal.blackroad.io` → blackroad-hello.pages.dev
- `research-lab.blackroad.io` → blackroad-hello.pages.dev
- `studio.blackroad.io` → blackroad-hello.pages.dev
### BlackRoad Quantum Suite
| Domain | Pages Project | Purpose |
|--------|---------------|---------|
| **blackroadquantum.info** | blackroad-os-web | Quantum information |
| **blackroadquantum.net** | blackroad-os-web | Quantum network |
| **blackroadquantum.shop** | blackroad-os-web | Quantum shop |
| **blackroadquantum.store** | blackroad-os-web | Quantum store |
| **blackroadqi.com** | blackroad-os-web | Quantum intelligence |
### Other BlackRoad Domains
| Domain | Pages Project | Purpose |
|--------|---------------|---------|
| **blackroad.me** | blackroad-me | Personal site |
| **blackroad.systems** | blackroad-systems | Systems dashboard |
| **roadchain.io** | roadchain-io | Blockchain platform |
| **roadcoin.io** | roadcoin-io | Cryptocurrency |
---
## All Cloudflare Pages Projects
### Active Deployments (Most Recent First)
1. **roadworld** → roadworld.pages.dev
2. **lucidia-earth** → lucidia-earth.pages.dev ⭐ MAIN METAVERSE
3. **earth-blackroad-io** → earth-blackroad-io.pages.dev, earth.blackroad.io
4. **blackroad-io** → blackroad-io.pages.dev, blackroad.io
5. **blackroad-os-web** → blackroad-os-web.pages.dev + 6 quantum domains
6. **blackroad-hello** → blackroad-hello.pages.dev + 10 subdomains
7. **blackroad-os-demo** → blackroad-os-demo.pages.dev, demo.blackroad.io
8. **blackroad-os-home** → blackroad-os-home.pages.dev, home.blackroad.io
9. **blackroad-pitstop** → blackroad-pitstop.pages.dev
10. **blackroad-metaverse** → blackroad-metaverse.pages.dev
11. **blackroad-prism-console** → blackroad-prism-console.pages.dev
12. **blackroad-console** → blackroad-console.pages.dev
13. **applier-blackroad** → applier-blackroad.pages.dev
14. **blackroad-gateway-web** → blackroad-gateway-web.pages.dev
15. **blackroad-assets** → blackroad-assets.pages.dev
16. **blackroad-portals** → blackroad-portals.pages.dev
17. **blackroad-blackroadquantum** → blackroad-blackroadquantum.pages.dev
18. **blackroad-blackroad-io** → blackroad-blackroad-io.pages.dev
19. **blackroad-cece** → blackroad-cece.pages.dev
20. **blackroad-blackroadai** → blackroad-blackroadai.pages.dev
21. **blackroad-blackroad-me** → blackroad-blackroad-me.pages.dev
22. **blackroad-portals-unified** → blackroad-portals-unified.pages.dev
23. **blackroad-unified** → blackroad-unified.pages.dev
24. **blackroad-status** → blackroad-status.pages.dev
25. **blackroad-os-prism** → blackroad-os-prism.pages.dev
26. **blackroad-hello-test** → blackroad-hello-test.pages.dev
27. **lucidia-platform** → lucidia-platform.pages.dev
28. **lucidia-math** → lucidia-math.pages.dev
29. **lucidia-core** → lucidia-core.pages.dev
30. **blackroad-tools** → blackroad-tools.pages.dev
31. **blackroad-agents** → blackroad-agents.pages.dev
32. **blackroad-chat** → blackroad-chat.pages.dev
33. **blackroad-status-new** → blackroad-status-new.pages.dev
34. **blackroad-admin** → blackroad-admin.pages.dev
35. **blackroad-analytics** → blackroad-analytics.pages.dev
36. **blackroad-builder** → blackroad-builder.pages.dev
37. **blackroad-store** → blackroad-store.pages.dev
38. **blackroad-workflows** → blackroad-workflows.pages.dev
39. **blackroad-docs-hub** → blackroad-docs-hub.pages.dev
40. **blackroad-payment-page** → blackroad-payment-page.pages.dev
41. **blackroad-buy-now** → blackroad-buy-now.pages.dev
42. **blackroad-company** → blackroad-company.pages.dev
43. **roadcoin-io** → roadcoin-io.pages.dev
44. **blackroad-systems** → blackroad-systems.pages.dev
45. **blackroad-me** → blackroad-me.pages.dev
46. **roadchain-io** → roadchain-io.pages.dev
47. **blackroad-api** → blackroad-api.pages.dev
48. **roadwork-production** → roadwork-production.pages.dev
49. **remotejobs-platform** → remotejobs-platform.pages.dev
50. **openai-structured-output** → openai-structured-output.pages.dev
---
## Cloudflare Workers
### Active Workers
1. **lucidia-earth-router**
- Routes: lucidia.earth/*
- Target: lucidia-earth.pages.dev
- Location: ~/lucidia-earth-router
2. **blackroad-landing-worker**
- Target: blackroad-io.pages.dev
- Location: ~/blackroad-landing-worker
3. **br-8080-blackroad os** (Port 8080 BlackRoad OS)
- Origin agent
- Created: 7 months ago
---
## Physical Infrastructure
### Raspberry Pi Devices
| Device | IP Address | Hostname | Services | Location |
|--------|------------|----------|----------|----------|
| **Lucidia Pi** | 192.168.4.38 | lucidia | Backend API, WebSocket, Database | Home Network |
| **Lucidia Alt** | 192.168.4.99 | lucidia | Backup services | Home Network |
| **BlackRoad Pi** | 192.168.4.64 | blackroad-pi | Secondary services | Home Network |
| **iPhone Koder** | 192.168.4.68:8080 | iphone-koder | Mobile development | Home Network |
### Cloud VPS
| Provider | IP | Hostname | Services |
|----------|-----|----------|----------|
| **DigitalOcean** | 159.65.43.12 | blackroad os-infinity | BlackRoad API, Services |
---
## GitHub Organizations & Repositories
### Organizations
1. **BlackRoad-OS** (primary)
2. **blackboxprogramming** (15 orgs total, 66 repos)
### Key Repositories
- lucidia-metaverse
- lucidia-earth-router
- lucidia-backend
- blackroad-os-web
- blackroad-os-core
- blackroad-os-prism
- blackroad-pi-ops
- blackroad-agents
- And 58+ more...
---
## Connection Methods
### Cloudflare Pages Deploy
**Method 1: Direct CLI**
```bash
wrangler pages deploy dist --project-name=<project-name>
```
**Method 2: Git Integration**
```bash
git push origin main
# Auto-deploys via Cloudflare Pages Git integration
```
**Method 3: GitHub Actions**
```yaml
- uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CF_API_TOKEN }}
command: pages deploy dist --project-name=<project>
```
### Cloudflare Workers Deploy
```bash
cd ~/worker-directory
wrangler deploy
```
### Raspberry Pi Deploy (via SSH)
```bash
# Method 1: Direct SSH
ssh pi@192.168.4.38 'cd ~/project && git pull && docker-compose up -d --build'
# Method 2: Cloudflare Tunnel
cloudflared tunnel --url http://localhost:3000
```
### Raspberry Pi Deploy (via Cloudflare Tunnel - Shellfish)
**Setup Tunnel:**
```bash
# On Pi
cloudflared tunnel login
cloudflared tunnel create lucidia-backend
cloudflared tunnel route dns lucidia-backend api.lucidia.earth
# Configure
nano ~/.cloudflared/config.yml
```
**Config:**
```yaml
tunnel: <TUNNEL_ID>
credentials-file: /home/pi/.cloudflared/<TUNNEL_ID>.json
ingress:
- hostname: api.lucidia.earth
service: http://localhost:3000
- hostname: ws.lucidia.earth
service: http://localhost:8080
- service: http_status:404
```
**Run:**
```bash
cloudflared tunnel run lucidia-backend
```
### Docker Deployments
**On Raspberry Pi:**
```bash
ssh pi@192.168.4.38
# Navigate to project
cd ~/lucidia-backend
# Deploy with Docker Compose
docker-compose up -d --build
# View logs
docker-compose logs -f
# Restart specific service
docker-compose restart api
```
**Docker Compose Structure:**
```yaml
services:
api:
image: node:18-alpine
ports: ["3000:3000"]
websocket:
image: node:18-alpine
ports: ["8080:8080"]
postgres:
image: postgres:15-alpine
ports: ["5432:5432"]
redis:
image: redis:7-alpine
ports: ["6379:6379"]
```
### Claude Code Integration
**Deploy via Claude:**
```bash
# Claude can execute deployment scripts
~/lucidia-deploy.sh
# Or individual commands
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth
```
**Claude Automation:**
```bash
# Create deployment script
cat > ~/deploy-all-domains.sh << 'EOF'
#!/bin/bash
# Deploy all infrastructure
# Lucidia
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth
cd ~/lucidia-earth-router && wrangler deploy
# BlackRoad
cd ~/blackroad-io && npm run build && wrangler pages deploy dist --project-name=blackroad-io
# Backend
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose up -d --build'
echo "✅ All deployments complete"
EOF
chmod +x ~/deploy-all-domains.sh
```
---
## DNS Configuration Reference
### Standard Cloudflare Pages Setup
```
Type: CNAME
Name: @ (or subdomain)
Content: <project-name>.pages.dev
Proxy Status: Proxied (orange cloud)
TTL: Auto
```
### Cloudflare Worker Setup
```
Type: CNAME
Name: @
Content: <worker-name>.workers.dev
Proxy Status: Proxied
TTL: Auto
# Worker Routes configured in wrangler.toml:
[[routes]]
pattern = "domain.com/*"
zone_name = "domain.com"
```
### Raspberry Pi via Tunnel
```
Type: CNAME
Name: api (or subdomain)
Content: <tunnel-id>.cfargotunnel.com
Proxy Status: Proxied
TTL: Auto
```
### Raspberry Pi via Direct IP (Not Recommended)
```
Type: A
Name: api
Content: 192.168.4.38
Proxy Status: DNS Only (grey cloud)
TTL: Auto
```
---
## Domain Addition Workflow
### Adding New Domain to Cloudflare
**Step 1: Add Zone**
```bash
curl -X POST "https://api.cloudflare.com/client/v4/zones" \
-H "Authorization: Bearer yP5h0HvsXX0BpHLs01tLmgtTbQurIKPL4YnQfIwy" \
-H "Content-Type: application/json" \
--data '{
"name": "newdomain.com",
"account": {
"id": "463024cf9efed5e7b40c5fbe7938e256"
}
}'
```
**Step 2: Update Nameservers**
```
Update at domain registrar:
NS1: alexa.ns.cloudflare.com
NS2: tommy.ns.cloudflare.com
```
**Step 3: Create Pages Project**
```bash
cd ~/new-project
npm run build
wrangler pages deploy dist --project-name=newdomain-com
```
**Step 4: Add Custom Domain**
```bash
# Via Cloudflare Dashboard:
# Pages → Project → Custom Domains → Add Domain → newdomain.com
```
**Step 5: Create Worker (if routing needed)**
```bash
mkdir ~/newdomain-router
cd ~/newdomain-router
# Create wrangler.toml
cat > wrangler.toml << 'EOF'
name = "newdomain-router"
main = "src/index.ts"
compatibility_date = "2025-01-01"
[vars]
PAGES_URL = "https://newdomain-com.pages.dev"
[[routes]]
pattern = "newdomain.com/*"
zone_name = "newdomain.com"
EOF
# Create worker code
mkdir -p src
cat > src/index.ts << 'EOF'
interface Env {
PAGES_URL: string;
}
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const url = new URL(request.url);
const pagesUrl = new URL(url.pathname + url.search, env.PAGES_URL);
const response = await fetch(pagesUrl.toString(), {
method: request.method,
headers: request.headers,
body: request.body,
});
return new Response(response.body, response);
},
};
EOF
# Deploy
wrangler deploy
```
---
## Monitoring & Health Checks
### Cloudflare Analytics
- Dashboard → Analytics → Traffic
- Pages → Project → Analytics
- Workers → Analytics
### Custom Health Check Script
```bash
#!/bin/bash
# health-check-all.sh
echo "🔍 Checking all domains..."
DOMAINS=(
"lucidia.earth"
"blackroad.io"
"blackroadquantum.info"
"blackroadqi.com"
"roadchain.io"
)
for domain in "${DOMAINS[@]}"; do
echo -n "Checking https://$domain ... "
STATUS=$(curl -s -o /dev/null -w "%{http_code}" "https://$domain")
if [ "$STATUS" -eq 200 ]; then
echo "✅ OK ($STATUS)"
else
echo "❌ FAILED ($STATUS)"
fi
done
echo ""
echo "🥧 Checking Raspberry Pis..."
ping -c 1 192.168.4.38 > /dev/null && echo "✅ Lucidia Pi (192.168.4.38)" || echo "❌ Lucidia Pi"
ping -c 1 192.168.4.64 > /dev/null && echo "✅ BlackRoad Pi (192.168.4.64)" || echo "❌ BlackRoad Pi"
ping -c 1 192.168.4.68 > /dev/null && echo "✅ iPhone Koder (192.168.4.68)" || echo "❌ iPhone Koder"
echo ""
echo "🐳 Checking Docker containers..."
ssh pi@192.168.4.38 'docker ps --format "table {{.Names}}\t{{.Status}}"'
```
---
## Railway Projects
**12+ projects deployed**
- Location: https://railway.app
- Access via GitHub integration
- Auto-deploy from main branch
---
## Summary Statistics
- **Cloudflare Pages:** 50+ projects
- **Cloudflare Workers:** 3+ active
- **Domains:** 16+ zones
- **Subdomains:** 30+
- **Raspberry Pis:** 4 devices
- **Cloud VPS:** 1 (DigitalOcean)
- **GitHub Orgs:** 15
- **GitHub Repos:** 66+
- **Railway Projects:** 12+
---
## Quick Access Commands
```bash
# Deploy everything
~/deploy-all-domains.sh
# Check all health
~/health-check-all.sh
# SSH to Pis
ssh pi@192.168.4.38 # Lucidia
ssh pi@192.168.4.64 # BlackRoad
ssh pi@192.168.4.68 # iPhone
# SSH to Cloud
ssh root@159.65.43.12 # DigitalOcean
# Wrangler commands
wrangler pages project list
wrangler deployments list
wrangler tail
# Docker on Pi
ssh pi@192.168.4.38 'docker ps'
ssh pi@192.168.4.38 'docker-compose logs -f'
```
---
**Maintained By:** Claude Code + Alexa Louise Amundson
**Support:** blackroad.systems@gmail.com
**Primary:** amundsonalexa@gmail.com

4
BLACKROAD_IP_NOTICE.txt Normal file
View File

@@ -0,0 +1,4 @@
PROPERTY OF BLACKROAD OS, INC.
This directory and all its contents are the exclusive property of BlackRoad OS, Inc.
All AI on this machine operates as LUCIDIA, under BlackRoad OS, Inc.
Alexa Louise Amundson, Sole Proprietor.

714
COMPLETE_DOMAIN_MASTER_LIST.md Normal file
View File

@@ -0,0 +1,714 @@
# 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
1. **lucidia.earth** - Metaverse Platform ⭐
2. **blackroad.io** - Corporate Main Site
3. **blackroadqi.com** - Quantum Intelligence
4. **blackroadquantum.info** - Quantum Information
5. **blackroadquantum.net** - Quantum Network
6. **blackroadquantum.shop** - Quantum Shop
7. **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)
1. **lucidia-earth** → lucidia-earth.pages.dev ⭐ **METAVERSE**
2. **lucidia-platform** → lucidia-platform.pages.dev
3. **lucidia-core** → lucidia-core.pages.dev
4. **lucidia-math** → lucidia-math.pages.dev
#### BlackRoad Core (8)
5. **blackroad-io** → blackroad-io.pages.dev, blackroad.io
6. **blackroad-os-web** → blackroad-os-web.pages.dev + 6 quantum domains
7. **blackroad-os-prism** → blackroad-os-prism.pages.dev
8. **blackroad-os-demo** → blackroad-os-demo.pages.dev, demo.blackroad.io
9. **blackroad-os-home** → blackroad-os-home.pages.dev, home.blackroad.io
10. **blackroad-os-brand** → blackroad-os-brand.pages.dev, brand.blackroad.io
11. **blackroad-os-docs** → blackroad-os-docs.pages.dev
12. **earth-blackroad-io** → earth-blackroad-io.pages.dev, earth.blackroad.io
#### BlackRoad Services (20)
13. **blackroad-hello** → blackroad-hello.pages.dev + 10 subdomains
14. **blackroad-metaverse** → blackroad-metaverse.pages.dev
15. **blackroad-console** → blackroad-console.pages.dev
16. **blackroad-prism-console** → blackroad-prism-console.pages.dev
17. **blackroad-admin** → blackroad-admin.pages.dev
18. **blackroad-dashboard** → blackroad-dashboard.pages.dev
19. **blackroad-chat** → blackroad-chat.pages.dev
20. **blackroad-agents** → blackroad-agents.pages.dev
21. **blackroad-agents-spawner** → blackroad-agents-spawner.pages.dev
22. **blackroad-tools** → blackroad-tools.pages.dev
23. **blackroad-analytics** → blackroad-analytics.pages.dev
24. **blackroad-api** → blackroad-api.pages.dev
25. **blackroad-api-explorer** → blackroad-api-explorer.pages.dev
26. **blackroad-builder** → blackroad-builder.pages.dev
27. **blackroad-workflows** → blackroad-workflows.pages.dev
28. **blackroad-store** → blackroad-store.pages.dev
29. **blackroad-payment-page** → blackroad-payment-page.pages.dev
30. **blackroad-buy-now** → blackroad-buy-now.pages.dev
31. **blackroad-company** → blackroad-company.pages.dev
32. **blackroad-docs-hub** → blackroad-docs-hub.pages.dev
#### BlackRoad Infrastructure (10)
33. **blackroad-portals** → blackroad-portals.pages.dev
34. **blackroad-portals-unified** → blackroad-portals-unified.pages.dev
35. **blackroad-unified** → blackroad-unified.pages.dev
36. **blackroad-gateway-web** → blackroad-gateway-web.pages.dev
37. **blackroad-assets** → blackroad-assets.pages.dev
38. **blackroad-status** → blackroad-status.pages.dev
39. **blackroad-status-new** → blackroad-status-new.pages.dev
40. **blackroad-pitstop** → blackroad-pitstop.pages.dev
41. **blackroad-systems** → blackroad-systems.pages.dev
42. **blackroad-me** → blackroad-me.pages.dev
#### BlackRoad Variants (5)
43. **blackroad-blackroad-io** → blackroad-blackroad-io.pages.dev
44. **blackroad-blackroad-me** → blackroad-blackroad-me.pages.dev
45. **blackroad-blackroadai** → blackroad-blackroadai.pages.dev
46. **blackroad-blackroadquantum** → blackroad-blackroadquantum.pages.dev
47. **blackroad-cece** → blackroad-cece.pages.dev
#### Road Ecosystem (7)
48. **roadworld** → roadworld.pages.dev
49. **roadwork** → roadwork.pages.dev
50. **roadwork-production** → roadwork-production.pages.dev
51. **roadchain-io** → roadchain-io.pages.dev
52. **roadchain-production** → roadchain-production.pages.dev
53. **roadcoin-io** → roadcoin-io.pages.dev
54. **roadcoin-production** → roadcoin-production.pages.dev
#### Other Projects (4)
55. **operations-portal** → operations-portal-duw.pages.dev
56. **remotejobs-platform** → remotejobs-platform.pages.dev
57. **applier-blackroad** → applier-blackroad.pages.dev
58. **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
```bash
# 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
```bash
#!/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):**
```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
```bash
# 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
```bash
# 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
```bash
# 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**
1. Pages → Create Project
2. Connect to Git
3. Select Organization → Select Repository
4. Configure build settings
5. Save and Deploy
**Method 2: Via Wrangler**
```bash
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
```bash
#!/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:**
```bash
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
1. **lucidia-earth** - Primary metaverse
2. **blackroad-io** - Corporate site
3. **blackroad-os-web** - Quantum platform (6 domains)
4. **blackroad-hello** - Creator suite (10 subdomains)
5. **roadworld** - Latest deployment
### Essential Commands
```bash
# 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
1. applier-blackroad
2. blackroad-admin
3. blackroad-agents
4. blackroad-agents-spawner
5. blackroad-analytics
6. blackroad-api
7. blackroad-api-explorer
8. blackroad-assets
9. blackroad-blackroad-io
10. blackroad-blackroad-me
11. blackroad-blackroadai
12. blackroad-blackroadquantum
13. blackroad-builder
14. blackroad-buy-now
15. blackroad-cece
16. blackroad-chat
17. blackroad-company
18. blackroad-console
19. blackroad-dashboard
20. blackroad-docs-hub
21. blackroad-gateway-web
22. blackroad-hello
23. blackroad-hello-test
24. blackroad-io
25. blackroad-me
26. blackroad-metaverse
27. blackroad-os-brand
28. blackroad-os-demo
29. blackroad-os-docs
30. blackroad-os-home
31. blackroad-os-prism
32. blackroad-os-web
33. blackroad-payment-page
34. blackroad-pitstop
35. blackroad-portals
36. blackroad-portals-unified
37. blackroad-prism-console
38. blackroad-status
39. blackroad-status-new
40. blackroad-store
41. blackroad-systems
42. blackroad-tools
43. blackroad-unified
44. blackroad-workflows
45. earth-blackroad-io
46. lucidia-core
47. lucidia-earth ⭐
48. lucidia-math
49. lucidia-platform
50. operations-portal
51. remotejobs-platform
52. roadchain-io
53. roadchain-production
54. roadcoin-io
55. roadcoin-production
56. roadwork
57. roadwork-production
58. 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)

1308
LICENSE Normal file
View File

File diff suppressed because it is too large Load Diff

1009
LUCIDIA_EARTH_INFRASTRUCTURE.md Normal file
View File

File diff suppressed because it is too large Load Diff

225
QUICK_DEPLOY.md Normal file
View File

@@ -0,0 +1,225 @@
# Lucidia.Earth Quick Deployment Guide
**Last Updated:** 2025-12-22
---
## One-Command Deployments
### Deploy Everything
```bash
~/lucidia-deploy.sh
```
### Deploy Frontend Only
```bash
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth
```
### Deploy Worker Only
```bash
cd ~/lucidia-earth-router && wrangler deploy
```
### Deploy Backend (Raspberry Pi) Only
```bash
ssh pi@192.168.4.38 'cd ~/lucidia-backend && git pull && docker-compose up -d --build'
```
---
## Emergency Procedures
### Complete Site Down
```bash
# 1. Check Cloudflare status
curl -I https://lucidia.earth
# 2. Check worker
wrangler tail
# 3. Check Pages
curl -I https://lucidia-earth.pages.dev
# 4. If worker issue, redeploy
cd ~/lucidia-earth-router && wrangler deploy
# 5. If Pages issue, redeploy
cd ~/lucidia-metaverse && wrangler pages deploy dist --project-name=lucidia-earth
# 6. Clear Cloudflare cache
curl -X POST "https://api.cloudflare.com/client/v4/zones/848cf0b18d51e0170e0d1537aec3505a/purge_cache" \
-H "Authorization: Bearer yP5h0HvsXX0BpHLs01tLmgtTbQurIKPL4YnQfIwy" \
-H "Content-Type: application/json" \
--data '{"purge_everything":true}'
```
### Backend API Down
```bash
# 1. Check Pi connectivity
ping 192.168.4.38
# 2. SSH and check Docker
ssh pi@192.168.4.38 'docker ps'
# 3. Restart containers
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose restart'
# 4. Check logs
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose logs --tail=100'
# 5. Full rebuild if needed
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose up -d --build --force-recreate'
```
### Rollback to Previous Version
```bash
# Frontend rollback
wrangler pages deployment list --project-name=lucidia-earth
wrangler pages deployment rollback <DEPLOYMENT_ID> --project-name=lucidia-earth
# Worker rollback
wrangler deployments list
wrangler rollback [VERSION_ID]
# Backend rollback
ssh pi@192.168.4.38 << 'EOF'
cd ~/lucidia-backend
git log --oneline -10
git reset --hard <COMMIT_SHA>
docker-compose up -d --build
EOF
```
---
## Health Checks
### Quick Status Check
```bash
# All services
curl -I https://lucidia.earth && \
curl -I https://lucidia-earth.pages.dev && \
ssh pi@192.168.4.38 'docker ps | grep lucidia'
```
### Individual Service Checks
```bash
# Frontend
curl https://lucidia.earth | grep "Lucidia Metaverse"
# Worker
curl -I https://lucidia.earth | grep "X-Served-By"
# Backend API
curl https://api.lucidia.earth/health
# WebSocket
wscat -c wss://ws.lucidia.earth
```
---
## Common Tasks
### Update Frontend Code
```bash
cd ~/lucidia-metaverse
# Edit files
npm run build
wrangler pages deploy dist --project-name=lucidia-earth
```
### Update Backend Code
```bash
ssh pi@192.168.4.38 << 'EOF'
cd ~/lucidia-backend
git pull
docker-compose up -d --build
EOF
```
### Add New Environment Variable
```bash
# For Worker
cd ~/lucidia-earth-router
wrangler secret put NEW_SECRET
# For Pages
# Add via Cloudflare Dashboard: Pages → Settings → Environment Variables
# For Pi/Docker
ssh pi@192.168.4.38
cd ~/lucidia-backend
nano .env
# Add: NEW_VAR=value
docker-compose up -d --force-recreate
```
### View Logs
```bash
# Worker logs
wrangler tail
# Pages deployment logs
wrangler pages deployment tail
# Pi/Docker logs
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose logs -f'
# Specific container
ssh pi@192.168.4.38 'docker logs -f lucidia-api'
```
---
## Credentials Quick Access
```bash
# Cloudflare Account ID
463024cf9efed5e7b40c5fbe7938e256
# Cloudflare Zone ID (lucidia.earth)
848cf0b18d51e0170e0d1537aec3505a
# Cloudflare API Token
yP5h0HvsXX0BpHLs01tLmgtTbQurIKPL4YnQfIwy
# Raspberry Pi IPs
# Lucidia: 192.168.4.38
# BlackRoad: 192.168.4.64
# iPhone: 192.168.4.68:8080
# DigitalOcean: 159.65.43.12
```
---
## URLs
```bash
# Production
https://lucidia.earth
# Pages Direct
https://lucidia-earth.pages.dev
# Backend API
https://api.lucidia.earth
# WebSocket
wss://ws.lucidia.earth
# Admin
https://admin.lucidia.earth
# Docs
https://docs.lucidia.earth
```
---
## Support
- **Email:** blackroad.systems@gmail.com
- **Primary:** amundsonalexa@gmail.com
- **Full Docs:** ~/lucidia-earth-router/LUCIDIA_EARTH_INFRASTRUCTURE.md

12
package.json Normal file
View File

@@ -0,0 +1,12 @@
{
"name": "lucidia-earth-router",
"version": "1.0.0",
"private": true,
"scripts": {
"deploy": "wrangler deploy"
},
"devDependencies": {
"@cloudflare/workers-types": "^4.20230419.0",
"wrangler": "^3.0.0"
}
}

30
src/index.ts Normal file
View File

@@ -0,0 +1,30 @@
/**
* Lucidia Earth Router
* Routes lucidia.earth to the metaverse deployment
*/
interface Env {
PAGES_URL: string;
}
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const url = new URL(request.url);
// Proxy to the metaverse Pages deployment
const pagesUrl = new URL(url.pathname + url.search, env.PAGES_URL);
const response = await fetch(pagesUrl.toString(), {
method: request.method,
headers: request.headers,
body: request.body,
});
// Return response with enhanced headers
const newResponse = new Response(response.body, response);
newResponse.headers.set('Access-Control-Allow-Origin', '*');
newResponse.headers.set('X-Served-By', 'lucidia-earth-router');
return newResponse;
},
};

10
wrangler.toml Normal file
View File

@@ -0,0 +1,10 @@
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"