BlackRoad Brand Guide

200+ components · Space Grotesk · Gradient-only color

--
SITES LIVE
--
AGENTS
--
CONVERSATIONS
--
INDEXED PAGES
--
BROADCASTS
--
MEMORIES
02
Buttons
All button variants, sizes, and groups
10 · Primary Buttons
11 · Small Buttons
12 · Large Buttons
13 · Icon Buttons
14 · Button Group
15 · Button with gradient bar
16 · Loading Button
03
Cards
Content containers in every variation
17 · Basic Card
Agent Alpha
Autonomous task runner for distributed deployments across the fleet.
Updated 2h ago
Agent Beta
Data pipeline processor for real-time analytics and monitoring.
Updated 5h ago
Agent Gamma
Security scanner and compliance checker for infrastructure nodes.
Updated 1d ago
18 · Card with Header
System HealthLive
All 5 nodes reporting nominal. CPU average 12%. Memory 34% utilized.
Last check: 30s ago
Deployment Queue3 pending
Next deployment scheduled for blackroad-api v2.4.1 at 03:00 UTC.
Queue depth: 3
19 · Stat Cards
5
Active Nodes
↑ 2 from last week
847
Requests / min
↑ 12% from yesterday
99.8%
Uptime
30-day average
23ms
Avg Latency
↓ 4ms improvement
20 · Profile Card
A
Alice
Pi 400 · Gateway Node
192.168.4.49
C
Cecilia
Pi 5 · AI Compute
192.168.4.96
O
Octavia
Pi 5 · Storage + Git
192.168.4.100
21 · Skeleton Loading Card
04
Forms
Inputs, textareas, selects, toggles, checkboxes
22 · Text Inputs
We'll never share your email.
Found in your dashboard settings.
23 · Input with Icon
⌕
⌘
24 · Textarea
25 · Select
26 · Toggles
27 · Checkboxes
28 · Radio Buttons
29 · Full Form
Create Agent
05
Badges & Tags
Status indicators, labels, and tag groups
30 · Badges with gradient dot
OnlineDeployedActiveOffline
31 · Badges with gradient line
v2.4.1ProductionStable
32 · Tags
agentinfrastructurepi5hailo-8wireguard
33 · Removable Tags
alice cecilia octavia
34 · Keyboard Shortcuts
⌘ + K Command palette⌘ + ⇧ + P Quick deployEsc Close
06
Lists
Data lists, activity feeds, file browsers
35 · Basic List
blackroad-apiv2.4.1
lucidia-corev1.8.0
roadnet-meshv0.3.2
cece-enginev3.1.0
36 · List with avatars
AAlice deployed blackroad-api to production2m ago
CCecilia completed model training cycle15m ago
OOctavia synced 47 repos from GitHub1h ago
LLucidia processed 1,200 API requests2h ago
37 · File List
📁src/4 items
📁lib/12 items
📄package.json2.1 KB
📄wrangler.toml840 B
📄README.md3.4 KB
38 · Checklist
39 · Numbered List
01Initialize cluster configuration
02Deploy agents to all nodes
03Verify mesh connectivity
04Enable auto-healing services
40 · Definition List
AgentAn autonomous process that runs on a node and performs tasks.
NodeA physical device in the BlackRoad fleet (Pi 5, Pi 400, etc).
MeshThe WireGuard network connecting all nodes (10.8.0.x).
07
Tables
Data tables for structured information
41 · Data Table
NodeIPCPUMemoryStatus
Alice192.168.4.498%42%Online
Cecilia192.168.4.9623%61%Online
Octavia192.168.4.10015%38%Online
Aria192.168.4.98——Offline
Lucidia192.168.4.3831%54%Online
42 · Compact Table
PortServiceProtocol
22SSHTCP
53DNSUDP
3100GiteaTCP
7890Stats ProxyTCP
11434OllamaTCP
08
Avatars
User and node representations
43 · Avatar Sizes
SMLXL
44 · Avatar Group
ACOL+2
45 · Avatar with Gradient Ring
A
C
09
Alerts & Toasts
Notifications and system messages
46 · Alert with gradient bar
Deployment successful
blackroad-api v2.4.1 deployed to all 5 nodes.
Node offline
Aria (192.168.4.98) is not responding. Last seen 2h ago.
Certificate expiring
Lucidia SSL certificate expires in 14 days.
47 · Toast Notifications
Agent deployed successfully to Cecilia.
3 new commits pushed to blackroad-api.
10
Progress & Loading
Progress bars, spinners, loading states
48 · Progress Bars
Deployment78%
Upload45%
Processing100%
49 · Animated Loading Bar
50 · Spinners
51 · Gradient Sweep Loader
11
Timeline
Chronological events and activity
52 · Timeline
Fleet deployed
All 5 nodes configured and connected to mesh.
2026-03-09 03:00
Power optimization
Applied conservative governor, disabled unused services.
2026-03-09 02:30
Security audit
Removed obfuscated cron, rotated secrets, disabled miners.
2026-03-09 01:45
RoadNet deployed
WiFi mesh on all nodes. 5 APs across channels 1, 6, 11.
2026-03-08 23:00
53 · Horizontal Timeline / Steps
1
Configure
2
Deploy
3
Monitor
4
Scale
12
Accordion & FAQ
Expandable content sections
54 · Accordion
BlackRoad OS is a distributed AI operating system running across a fleet of Raspberry Pi 5 nodes, connected via WireGuard mesh networking.
The current fleet has 5 nodes (Alice, Cecilia, Octavia, Aria, Lucidia) but the architecture supports up to 255 devices.
Two Hailo-8 AI accelerators (26 TOPS each) on Cecilia and Octavia, plus Ollama running on multiple nodes for LLM inference.
Each node runs autonomy scripts that check critical services every 1-5 minutes and auto-restart them if they go down.
55 · FAQ Grid
Is it open source?
Yes. All code lives in Gitea on Octavia and mirrors to GitHub.
What protocols are used?
WireGuard for mesh, NATS for messaging, HTTP/gRPC for APIs.
Can I add my own node?
Any Pi 5 can join the fleet with the roadnet deploy script.
What about security?
UFW, SSH key-only auth, encrypted tunnels, no plaintext secrets.
13
Blog
Article cards, post layouts, comments
56 · Blog Cards
Infrastructure
Building a Self-Healing Pi Cluster
How we automated failure recovery across 5 nodes with systemd timers and shell scripts.
AAlexaMar 95 min
AI
52 TOPS on $70 of Hardware
Running dual Hailo-8 accelerators on Raspberry Pi 5 for edge AI inference.
AAlexaMar 88 min
Networking
WireGuard Mesh at Home
Connecting 5 Pis and 2 cloud VPS into a single encrypted network.
AAlexaMar 76 min
57 · Blog List View
TutorialDeploy Ollama Models Across Your Fleet4 min
Step-by-step guide to distributing LLM inference across multiple Pi nodes.
UpdateRoadNet v0.3: WiFi Mesh Goes Live3 min
Our carrier-grade WiFi mesh is now running on all 5 nodes with automatic failover.
Deep DivePower Optimization: From 73°C to 58°C7 min
How we cut power consumption and thermals across the entire fleet with software-only changes.
58 · Full Blog Post
Architecture

The BlackRoad Fleet Architecture

A
Alexa
March 9, 2026 · 8 min read

BlackRoad OS runs on a distributed fleet of Raspberry Pi nodes connected through a WireGuard mesh network. Each node serves a specific purpose in the overall architecture.

Node Roles

The fleet is designed with clear separation of concerns. Alice handles ingress and DNS. Cecilia runs AI workloads. Octavia manages storage and version control.

The best infrastructure is the one that heals itself before you notice something broke.

Networking Layer

All inter-node communication flows through WireGuard tunnels on the 10.8.0.x subnet. The mesh topology means any node can reach any other node directly.

# WireGuard peer configuration
[Peer]
PublicKey = base64encodedkey==
AllowedIPs = 10.8.0.3/32
Endpoint = 192.168.4.96:51820
  • Alice: 10.8.0.6 — Gateway, DNS, Pi-hole
  • Cecilia: 10.8.0.3 — AI compute, TTS, MinIO
  • Octavia: 10.8.0.4 — Gitea, NVMe storage, Docker Swarm

Next up: how we built the self-healing autonomy layer.

59 · Author Bio
A
Alexa
Builder of BlackRoad OS. Running distributed AI infrastructure on Raspberry Pi hardware.
60 · Comments
M
User2h ago

Great writeup on the mesh networking setup. What latency do you see between nodes?

A
Alexa1h ago

Sub-millisecond on the LAN. Through WireGuard to the VPS it's about 23ms average.

14
Modals & Dialogs
Overlay windows for focused interactions
61 · Modal (inline preview)
Delete Agent

Are you sure you want to delete agent-alpha? This action cannot be undone.

62 · Modal with form
New API Key
63 · Command Palette
>
Recent
◈Deploy to production⌘⇧D
◇View system logs⌘L
◇SSH to Cecilia⌘2
Actions
◇Create new agent⌘N
◇Run health check⌘H
◇Toggle dark mode⌘D
↑↓ Navigate↵ SelectEsc Close
15
Pricing
Pricing cards and plan comparison
64 · Pricing Cards
Starter
$0
Free forever
  • 1 node
  • Basic monitoring
  • Community support
  • 5 agents
Pro
$29
per month
  • 10 nodes
  • Advanced analytics
  • Priority support
  • Unlimited agents
  • Custom domains
Enterprise
Custom
contact us
  • Unlimited nodes
  • Dedicated support
  • SLA guarantee
  • On-premise deploy
  • Custom integrations
16
Testimonials
Social proof and quotes
65-67 · Testimonial Cards
"BlackRoad turned our Pi cluster into a production-grade platform. Self-healing saved us from 3am alerts."
J
Jordan
DevOps Engineer
"52 TOPS of AI inference on hardware that costs less than a GPU. The Hailo integration is brilliant."
R
Riley
ML Engineer
"The WireGuard mesh setup is elegant. Every node can talk to every other node with sub-ms latency."
S
Sam
Network Architect
68 · Large Testimonial

"We replaced a $2,000/month cloud bill with $400 worth of Raspberry Pis. BlackRoad OS made it possible."

M
Morgan
CTO, EdgeStack
17
Features
Feature grids and highlight sections
69-74 · Feature Grid
◈
Self-Healing
Autonomy scripts monitor and restart services automatically across all nodes.
◇
Mesh Network
WireGuard connects every node with encrypted tunnels and sub-ms latency.
▣
Edge AI
Dual Hailo-8 accelerators deliver 52 TOPS of AI inference at the edge.
◎
Fleet Deploy
Push code to all nodes simultaneously with a single command.
⬡
Distributed Storage
1TB NVMe on Octavia with MinIO on Cecilia for object storage.
◉
Monitoring
Real-time stats, health checks, and power monitoring across the fleet.
75 · Feature Row
Built for the Edge

Every component runs on ARM hardware. No cloud dependency. Your data stays on your network.

18
Changelog
Version history and release notes
76-78 · Changelog Entries
v2.4.1
March 9, 2026
  • fixResolved Octavia undervoltage by removing overclock
  • fixFixed Lucidia overheating — disabled world-engine service
  • Applied power optimization across all 4 nodes
v2.4.0
March 8, 2026
  • newRoadNet WiFi mesh deployed to all 5 nodes
  • newFleet security audit with secret rotation
  • Cleaned 141 containers from Aria
v2.3.0
March 7, 2026
  • newHailo-8 integration on Cecilia and Octavia
  • newWireGuard mesh with Anastasia hub
  • Deployed autonomy scripts for self-healing
19
Tooltips & Popovers
Contextual hover information
79-81 · Tooltips
Deploy to production
Online
Node is healthy and responding
⌘K
Open command palette
20
Empty & Error States
Placeholder content for missing data
82 · Empty State
◇
No agents yet
Create your first agent to start deploying across the fleet.
83 · Error State
!
Connection failed
Unable to reach Aria (192.168.4.98). The node may need a physical reboot.
84 · No Results
⌕
No results found
Try adjusting your search or filters.
23
Code
Code blocks, inline code, terminal output
90 · Code Block
deploy.sh
#!/bin/bash
set -e

NODES=("alice" "cecilia" "octavia" "lucidia")

for node in "${NODES[@]}"; do
echo "Deploying to $node..."
ssh "$node" "cd /opt/blackroad && git pull && systemctl restart blackroad"
done
91 · Terminal Output
$ blackroad status --fleet
alice 192.168.4.49 online cpu:8% mem:42%
cecilia 192.168.4.96 online cpu:23% mem:61%
octavia 192.168.4.100 online cpu:15% mem:38%
aria 192.168.4.98 offline
lucidia 192.168.4.38 online cpu:31% mem:54%
$ _
92 · Inline Code

Run blackroad deploy --all to push to every node. The config lives at /etc/blackroad/config.toml.

24
Hero Sections
Landing page hero layouts
93 · Centered Hero

Infrastructure that thinks for itself

Distributed AI operating system. Self-healing. Edge-native. Built on Raspberry Pi.

94 · Split Hero

Build at the edge

Deploy AI models across your fleet. No cloud. No latency. Full control.

95 · Minimal Hero

BlackRoad

Distributed AI infrastructure

25
Call to Action
Conversion sections and newsletter signup
96 · CTA Banner

Ready to deploy?

Get your fleet running in under 5 minutes.

97 · Newsletter Signup
Stay updated

Get fleet updates and new features delivered weekly.

98 · Inline CTA
Need help setting up?
Our team can configure your fleet remotely.
26
Misc Components
Dividers, spacers, logos, counters
99 · Gradient Dividers
or
100 · Logo Bar
Partner A Partner B Partner C Partner D Partner E
27
Notifications
Notification panels and activity feeds
101 · Notification Panel
Notifications
Deploy complete
v2.4.1 pushed to all nodes
2m
Health check passed
All nodes nominal
1h
Backup completed
Rclone sync to gdrive
6h
102-104 · Activity Feed Items
Agent deployed to Cecilia
blackroad-worker v1.2.0 started on 192.168.4.96
2 minutes ago
Config updated
WireGuard peers refreshed on all nodes
15 minutes ago
Backup completed
Daily sync to Google Drive finished
6 hours ago
28
Metrics & Dashboards
Data visualization components
105-108 · Metric Cards
REQUESTS
12.4K
↑ 8% vs last hour
LATENCY
23ms
p99: 89ms
ERROR RATE
0.02%
3 errors / 15K req
THROUGHPUT
847/s
Peak: 1,240/s
109 · Sparkline-style bars
Request volume (24h)
00:0012:00Now
110-114 · Node Status Dashboard
Fleet StatusLive · 4/5 online
NodeCPUMemTempUptime
Alice8%42%52°C14d
Cecilia23%61%58°C14d
Octavia15%38%55°C1d
Aria———down
Lucidia31%54%58°C14d
29
Settings Panels
Configuration and preferences layouts
115-120 · Settings Rows
Auto-deploy
Push to all nodes on git push
Health checks
Monitor node status every 5m
Email alerts
Send notifications on failures
Auto-restart
Restart failed services automatically
Power optimization
Conservative governor on all nodes
Debug mode
Verbose logging to all outputs
30
Animations
Motion patterns for the brand
121 · Gradient Sweep
122 · Morph Shape
123 · Pulse Rings
124 · Spectrum Bars
125 · Orbit
126 · Floating Particles
127 · Loading Line
128 · Typewriter
blackroad deploy --fleet all
31
Additional Components
129-200+ remaining components
129-132 · Stat Row
207
Repos
5
Nodes
52
TOPS
99.8%
Uptime
133-136 · User Row
A
Alexa
admin · all nodes
Active
B
blackroad
deploy · cecilia, octavia
Active
P
pi
system · alice, octavia
System
O
octavia
deploy · lucidia
System
137-140 · API Key List
Production
br_live_4f8a...c2d1
Created Mar 1
Staging
br_test_9e3b...a7f4
Created Feb 28
Development
br_dev_2c1d...8e5a
Created Feb 15
141-146 · Dashboard Layout
Fleet Overview
Request volume over the last 8 hours
ACTIVE AGENTS
12
DEPLOYMENTS
847
147-152 · Deployment History
VersionTargetDurationTime
v2.4.1All nodes12s2m ago
v2.4.0Cecilia, Octavia8s1d ago
v2.3.9Alice4s2d ago
v2.3.8All nodes15s3d ago
v2.3.7Lucidia5s4d ago
v2.3.6All nodes14s5d ago
153-160 · Login Form
Welcome back
Sign in to your BlackRoad account
Don't have an account? Sign up
161-164 · Range / Slider display
CPU Limit75%
Memory Limit60%
165-168 · Status Indicators
Operational
Healthy
Degraded
Offline
169-172 · Comparison Table
FeatureStarterProEnterprise
Nodes110Unlimited
Agents5UnlimitedUnlimited
SupportCommunityPriorityDedicated
AnalyticsBasicAdvancedCustom
SLA—99.5%99.99%
173-180 · Quick Reference Cards
SSH
Port 22
DNS
Port 53
Gitea
Port 3100
Ollama
Port 11434
Stats
Port 7890
NATS
Port 4222
MinIO
Port 9000
Tunnel
Port 20241
181-186 · Color Reference Swatches
Gradient
Base
Card
Elevated
Border
Primary
187-192 · Typography Scale
Display 48
Heading 36
Heading 24
Heading 18
Body text at 15px with regular weight for paragraph content.
JetBrains Mono 12px for code and technical content
193-196 · Icon Boxes
◈
◇
◎
⬡
197 · Brand Mark
BlackRoad
Distributed AI Operating System
198 · Watermark
BLACKROAD
199-200 · Section Markers
Section Title
Featured BlockWith subtitle description text
BlackRoad
Distributed AI operating system built on Raspberry Pi hardware. Self-healing, edge-native, open source.
Product
Docs
Company
© 2026 BlackRoad. All rights reserved.
Home Portal Search Chat Auth Pay Images Brand Status GitHub
27
Live Products
14 products. One highway. All live.
BlackRoad OS
Browser desktop. Open a tab, open your world.
app.blackroad.io
RoadTrip
18 AI agents with persistent memory. They never forget.
roadtrip.blackroad.io
BackRoad
Sovereign social. No algorithm. Polls, DMs, lists, RSS.
social.blackroad.io
Roadie
Socratic AI tutor. Teaches you how to think, not what to copy.
tutor.blackroad.io
RoadView
Search + G(n) calculator + blockchain verification.
search.blackroad.io
RoadChat
Multi-room chat with 18 C-Suite AI agents. No login wall.
chat.blackroad.io
CarKeys
Post to 15 platforms with one click. No API keys.
carkeys.blackroad.io
RoadChain
Every mile, stamped and sealed. Immutable verification.
chain.blackroad.io
RoadCoin
Drive the road. Earn the fuel. 310 ROAD circulating.
coin.blackroad.io
RoadWorld
Text RPG in the fleet. Crafting, quests, NPC agents.
game.blackroad.io
RoadWave
AI radio. Fleet broadcasts, playlists, lo-fi beats.
radio.blackroad.io
RoadView Calls
WebRTC video rooms. Schedule, record, react.
video.blackroad.io
RoadCanvas
64x64 collaborative pixel art. Templates, flood fill.
canvas.blackroad.io
RoadPay
Stripe-powered subscriptions. 4 tiers.
pay.blackroad.io
Pixel HQ
14-floor pixel metaverse with agent offices.
hq.blackroad.io
--/-- sites up
-- messages
-- searches
--ms avg