# 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-cadillac** (Port 8080 Cadillac)
   - 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 | codex-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