🦞 LobsterBoard

A self-hosted, drag-and-drop dashboard builder with 60+ widgets, a template gallery, custom pages, and zero cloud dependencies. One Node.js server, no frameworks, no build step needed.

Works standalone or with OpenClaw. LobsterBoard is a general-purpose dashboard — use it to monitor your homelab, track stocks, display weather, manage todos, or anything else. OpenClaw users get bonus widgets (auth status, cron jobs, activity logs), but they're completely optional.

Quick Start

npm install lobsterboard
cd node_modules/lobsterboard
node server.cjs

Or clone it:

git clone https://github.com/Curbob/LobsterBoard.git
cd LobsterBoard
npm install
node server.cjs

Open http://localhost:8080 → press Ctrl+E to enter edit mode → drag widgets from the sidebar → click 💾 Save.

Features

• Drag-and-drop editor — visual layout with 20px snap grid, resize handles, property panel
• 60+ widgets — system monitoring, weather, calendars, RSS, smart home, finance, AI/LLM tracking, notes, and more
• Template Gallery — export, import, and share dashboard layouts with auto-screenshot previews; import as merge or full replace
• Custom pages — extend your dashboard with full custom pages (notes, kanban boards, anything)
• Canvas sizes — preset resolutions (1920×1080, 2560×1440, etc.) or custom sizes
• Live data — system stats stream via Server-Sent Events, widgets auto-refresh
• 5 themes — Default (dark), Terminal (CRT green), Feminine (pastel pink), Feminine Dark, Paper (sepia)
• No cloud — everything runs locally, your data stays yours

Themes

LobsterBoard ships with 5 built-in themes. Switch themes from the dropdown in edit mode — your choice persists across sessions.

Default	Terminal	Paper

Feminine	Feminine Dark

• Default — dark theme with emoji icons (the classic look)
• Terminal — green CRT aesthetic with scanlines and Phosphor icons
• Paper — warm cream/sepia tones, serif fonts, vintage feel
• Feminine — soft pink and lavender pastels with subtle glows
• Feminine Dark — pink/purple accents on a dark background

Remote Server Monitoring

Monitor multiple servers from a single dashboard using lobsterboard-agent.

Setup Remote Server

On your VPS/remote server:

npm install -g lobsterboard-agent
lobsterboard-agent init     # Generates API key - save it!
lobsterboard-agent serve    # Starts on port 9090

Add to LobsterBoard

1. Click 🖥️ Servers in the header
2. Enter server name, URL (http://your-server-ip:9090), and API key
3. Click Test Connection to verify
4. Add widgets (Uptime Monitor, Docker, CPU/Memory, etc.)
5. Select your remote server from the Server dropdown in widget properties

Supported Widgets

These widgets support remote server data:

Widget	What It Shows
Uptime Monitor	System uptime, CPU, memory
CPU / Memory	CPU usage + RAM usage
Disk Usage	Disk space with ring chart
Network Speed	Upload/download throughput
Docker Containers	Container list and status

Multi-Server Dashboard

Add multiple widgets and select different servers for each — monitor your entire infrastructure from one dashboard.

Configuration

PORT=3000 node server.cjs              # Custom port
HOST=0.0.0.0 node server.cjs           # Expose to network

Widget settings are edited in the right-hand panel during edit mode. All configuration saves to config.json.

Template Gallery

LobsterBoard includes a built-in template system for sharing and reusing dashboard layouts.

• Export your current dashboard as a template (auto-captures a screenshot preview)
• Browse the template gallery to discover pre-built layouts
• Import templates in two modes:
• Replace — swap your entire dashboard for the template
• Merge — append the template's widgets below your existing layout
• Templates are stored in the templates/ directory and can be shared as folders

Widgets

🖥️ System Monitoring

Widget	Description
CPU / Memory	Real-time CPU load and memory usage
Disk Usage	Disk space with ring gauge
Network Speed	Upload/download throughput
Uptime Monitor	System uptime, CPU load, memory summary
Docker Containers	Container list with status

🌤️ Weather

Widget	Description
Local Weather	Current conditions for your city
World Weather	Multi-city weather overview

⏰ Time & Productivity

Widget	Description
Clock	Analog/digital clock
World Clock	Multiple time zones
Countdown	Timer to a target date
Todo List	Persistent task list
Pomodoro Timer	Work/break timer
Notes	Persistent rich-text notes with auto-save

📰 Media & Content

Widget	Description
RSS Ticker	Scrolling feed from any RSS/Atom URL
Calendar	iCal feed display (Google, Apple, Outlook)
Now Playing	Currently playing media
Quote of Day	Random inspirational quotes
Quick Links	Bookmark grid

🤖 AI / LLM Monitoring

Track your AI coding subscriptions in real-time. Inspired by OpenUsage by Robin Ebers.

Widget	Description	Setup
AI Usage	Combined view of all providers	—
Claude Code	Session, weekly, Opus limits	Run claude once
Codex CLI	Session, weekly, code reviews	Run codex once
GitHub Copilot	Premium, chat, completions	Run gh auth login
Cursor	Credits, usage breakdown	Just use Cursor IDE
Gemini CLI	All available Gemini CLI quota buckets	Run gemini once
Amp	Free tier, credits	Run amp once
Factory / Droid	Standard, premium tokens	Run factory once
Kimi Code	Session, weekly	Run kimi once
JetBrains AI	Quota tracking	Sign in via IDE
Antigravity	Gemini 3, Claude via Google	Run antigravity-usage login
MiniMax	Coding plan session	Set MINIMAX_API_KEY
Z.ai	Session, weekly	Set ZAI_API_KEY
AI Cost Tracker	Monthly cost breakdown	—
API Status	Provider availability	—
Active Sessions	OpenClaw session monitor	—
Token Gauge	Context window usage	—

💰 Finance

Widget	Description
Stock Ticker	Live stock prices (requires API key)
Crypto Price	Cryptocurrency tracker

🏠 Smart Home

Widget	Description
Indoor Climate	Temperature/humidity sensors
Camera Feed	IP camera stream
Power Usage	Energy monitoring

🔗 Embeds & Media

Widget	Description
Image / Random Image / Web Image / Latest Image	Static, rotating, remote, or latest images (with browse button for directory selection)
Iframe Embed	Embed any webpage

🔧 Utility

Widget	Description
Auth Status	Authentication status display
Sleep Score	Garmin sleep score widget
GitHub Stats	Repository stats — stars, forks, open issues, open PRs
Unread Emails	Email inbox counter
System Log	Recent system log entries
Activity List	Activity timeline
Cron Jobs	Cron job status monitor
LobsterBoard Release	Version update checker
OpenClaw Release	OpenClaw version checker
Release	Generic release tracker

🎨 Layout

Widget	Description
Header / Text	Custom text with formatting
Horizontal Line	Divider
Vertical Line	Vertical divider
Pages Menu	Navigation for custom pages

Custom Pages

LobsterBoard includes a pages system for adding full custom pages beyond the widget dashboard. Pages get their own route, nav entry, and optional server-side API.

pages/
└── my-page/
    ├── page.json       # Metadata (title, icon, order)
    ├── index.html      # Page UI
    └── api.cjs         # Optional: server-side API routes

Pages are auto-discovered on startup. Drop a folder in pages/, restart the server, and it appears in the nav.

👉 Full guide with examples: pages/README.md

Run on Boot

macOS (launchd)

cat > ~/Library/LaunchAgents/com.lobsterboard.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key><string>com.lobsterboard</string>
    <key>RunAtLoad</key><true/>
    <key>KeepAlive</key><true/>
    <key>ProgramArguments</key>
    <array>
      <string>/usr/local/bin/node</string>
      <string>/path/to/lobsterboard/server.cjs</string>
    </array>
    <key>WorkingDirectory</key><string>/path/to/lobsterboard</string>
    <key>EnvironmentVariables</key>
    <dict>
      <key>PORT</key><string>8080</string>
      <key>HOST</key><string>0.0.0.0</string>
    </dict>
  </dict>
</plist>
EOF

launchctl load ~/Library/LaunchAgents/com.lobsterboard.plist

Update the paths to match your install location and Node.js binary (which node).

Linux (systemd)

sudo cat > /etc/systemd/system/lobsterboard.service << 'EOF'
[Unit]
Description=LobsterBoard Dashboard
After=network.target

[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/lobsterboard
ExecStart=/usr/bin/node server.cjs
Environment=PORT=8080 HOST=0.0.0.0
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable lobsterboard
sudo systemctl start lobsterboard

pm2 (any OS)

npm install -g pm2
cd /path/to/lobsterboard
PORT=8080 HOST=0.0.0.0 pm2 start server.cjs --name lobsterboard
pm2 save
pm2 startup

API Endpoints

Endpoint	Method	Description
/config	GET/POST	Load/save dashboard layout
/api/stats/stream	GET	Live system stats (SSE)
/api/pages	GET	List custom pages
/api/todos	GET/POST	Todo list data
/api/notes	GET/POST	Notes widget data
/api/templates	GET	List available templates
/api/templates/:id	GET	Get template config
/api/templates/:id/preview	GET	Template preview image
/api/templates/import	POST	Import a template (merge/replace)
/api/templates/export	POST	Export current dashboard as template
/api/calendar?url=	GET	Proxy iCal feed
/api/rss?url=	GET	Proxy RSS/Atom feed
/api/lb-release	GET	LobsterBoard version check

File Structure

lobsterboard/
├── server.cjs          # Node.js server
├── app.html            # Dashboard builder
├── config.json         # Your saved layout
├── js/
│   ├── builder.js      # Editor: drag-drop, zoom, config I/O
│   ├── widgets.js      # All 50 widget definitions
│   └── templates.js    # Template gallery & export system
├── css/
│   └── builder.css     # Dark theme styles
├── templates/          # Dashboard templates
│   ├── templates.json  # Template index
│   └── */              # Individual template folders
├── pages/              # Custom pages (auto-discovered)
│   └── README.md       # Page creation guide
└── package.json

Community Widgets

Community contributions are welcome! Build your own widget and share it with the LobsterBoard community.

• 📖 Contributing Guide — how to create and submit a widget
• 📁 Community Widgets — browse contributed widgets and the starter template

License

This project is licensed under the Business Source License 1.1 (BSL-1.1).

You are free to use, modify, and self-host LobsterBoard for non-commercial purposes. Commercial use requires a separate license. See LICENSE for full terms.

Commercial Licensing

For commercial use, OEM licensing, or enterprise deployments, contact:

📧 curbob on GitHub — github.com/Curbob

---

Made with 🦞 by Curbob