lobsterboard 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,95 @@
+# LobsterBoard Changelog
+
+All notable changes to LobsterBoard will be documented in this file.
+
+---
+
+## [Unreleased]
+
+### Fixed
+- Text-header widget "Show Border" checkbox now works — toggling it off removes the card background, border, and box-shadow from the `.placed-widget` container
+- Fix text-header, horizontal-line, and vertical-line widgets disappearing after save/reload — unknown widget types (e.g. removed `topbar`) crashed `renderWidget`, stopping all subsequent widgets from loading
+- Add guard in `renderWidget` to skip unknown widget types gracefully
+- Wrap each widget render in try/catch so one bad widget can't prevent others from loading
+
+---
+
+## [0.1.0] - 2026-02-05
+
+### 🎉 Initial Release
+
+The first public version of LobsterBoard - a visual dashboard builder for the OpenClaw community.
+
+### Added
+
+#### Core Builder
+- Drag-and-drop widget placement on canvas
+- Grid snapping (20px) for precise alignment
+- Widget resize handles
+- Properties panel for configuring widgets
+- Live preview modal with inlined styles
+- Export to ZIP (standalone HTML/CSS/JS)
+
+#### Canvas Features
+- 15+ screen size presets (1080p, 4K, tablets, ultrawide, portrait)
+- Custom dimension support
+- Zoom controls (+/-, Fit, 1:1)
+- Keyboard shortcuts (Ctrl +/-, Ctrl+scroll)
+
+#### Widgets (40+)
+- **AI/LLM:** Claude Usage, GPT Usage, Gemini Usage, AI Usage (All), Cost Tracker, API Status, Active Sessions, Token Gauge
+- **Basics:** Local Weather, World Weather, Clock, World Clock, Countdown, Stat Card, Battery Status
+- **System:** CPU/Memory, Disk Usage, Network Speed, Docker, Uptime Monitor
+- **OpenClaw:** Auth Status, Sleep Ring, Release, Activity List, Cron Jobs, System Log
+- **Productivity:** Todo List, Calendar, Email Count, Pomodoro, Notes, GitHub Stats
+- **Finance:** Stock Ticker, Crypto Price
+- **Smart Home:** Indoor Climate, Camera Feed, Power Usage
+- **Entertainment:** Now Playing, Quote of Day
+- **Content:** Quick Links, RSS Feed, Image Embed, Iframe Embed
+- **Bars:** Top Nav Bar, News Ticker, RSS Ticker
+
+#### Branding
+- LobsterBoard name and mascot 🦞
+- Logo wordmark for header
+- Mascot illustration for sidebar
+- Favicon and Apple touch icon
+
+#### Design
+- Dark theme matching OpenClaw aesthetic
+- Consistent `dash-card` styling across all widgets
+- Widget headers with icons
+- Sample data display (no loading spinners in builder)
+
+### Technical Notes
+- Weather widgets use wttr.in (free, no API key required)
+- API keys stored as placeholders for users to fill in post-export
+- AI usage widgets require backend proxy due to CORS
+
+---
+
+## [0.1.1] - 2026-02-06
+
+### Changed
+- Moved mascot from left sidebar to right (properties panel)
+- Mascot now pinned to bottom of panel (doesn't float up)
+
+### Fixed
+- Mascot positioning with `margin-top: auto` in flexbox
+
+---
+
+## Upcoming
+
+### Planned Features
+- GitHub Pages deployment
+- Import/export dashboard layouts (JSON)
+- Widget templates and presets
+- More customization options
+- Community widget contributions
+
+---
+
+## Links
+
+- **GitHub:** https://github.com/curbob/LobsterBoard
+- **Issues:** https://github.com/curbob/LobsterBoard/issues

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 curbob
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,161 @@
+# 🦞 LobsterBoard
+
+A drag-and-drop dashboard builder for creating beautiful, customizable status boards.
+
+![LobsterBoard](lobsterboard-logo-final.png)
+
+## Features
+
+- **Visual Builder**: Drag and drop widgets onto a grid
+- **47+ Widgets**: Weather, clocks, system stats, AI usage, and more
+- **Dark Theme**: Easy on the eyes, perfect for always-on displays
+- **Export to HTML**: Single-file dashboards that run anywhere
+- **No Backend Required**: Many widgets work with just a browser
+
+## Quick Start
+
+1. Open `index.html` in your browser
+2. Drag widgets from the sidebar onto the canvas
+3. Click widgets to edit their properties
+4. Click **Export Dashboard** to download your dashboard
+
+## Widget Categories
+
+### ✅ Works Out of Box (No API Needed)
+These widgets work immediately with no configuration:
+- Weather (wttr.in)
+- Clock, World Clock
+- Countdown, Pomodoro Timer
+- Images (local, web, random rotation)
+- Quick Links
+- Iframe Embed
+- Release Tracker (GitHub public API)
+
+### 🦞 OpenClaw Widgets
+These widgets connect to a running [OpenClaw](https://github.com/openclaw/openclaw) gateway:
+- Auth Status
+- OpenClaw Release
+- Activity List
+- Cron Jobs
+- System Log
+- Session Count
+- Token Gauge
+
+**See [Using OpenClaw Widgets](#using-openclaw-widgets) below.**
+
+### 🔑 API Key Required
+These widgets need you to provide an API key:
+- News Ticker (NewsAPI)
+- Stock Ticker (Finnhub)
+- GitHub Stats (optional, for higher rate limits)
+
+### ⚠️ Custom Backend Required
+These widgets need custom API endpoints:
+- AI Usage (Claude, GPT, Gemini)
+- CPU/Memory, Disk Usage
+- Docker Containers
+- And more...
+
+---
+
+## Using OpenClaw Widgets
+
+OpenClaw widgets fetch data from your local OpenClaw gateway. Due to browser CORS restrictions, you need to either:
+
+### Option A: Use the Included Server (Recommended)
+
+The server proxies API requests to OpenClaw, solving CORS issues.
+
+1. **Export your dashboard** from the builder (Download button)
+
+2. **Extract the ZIP** to a folder
+
+3. **`server.js` is included** in the exported ZIP
+
+4. **Run the server**:
+   ```bash
+   cd your-dashboard-folder
+   node server.js
+   ```
+
+5. **Open** http://localhost:8080 in your browser
+
+**Configuration** (environment variables):
+```bash
+# Custom port for the dashboard server
+PORT=3000 node server.js
+
+# Custom OpenClaw gateway URL (if not on default port 18789)
+OPENCLAW_URL=http://localhost:YOUR_PORT node server.js
+
+# Expose to network (⚠️ only on trusted networks!)
+HOST=0.0.0.0 node server.js
+```
+
+> **⚠️ Non-Default Gateway Port?**
+> 
+> If your OpenClaw gateway runs on a port other than `18789` (the default), you **must** set the `OPENCLAW_URL` environment variable. Check your gateway port:
+> ```bash
+> grep '"port"' ~/.openclaw/openclaw.json
+> ```
+> Then start the server with:
+> ```bash
+> OPENCLAW_URL=http://localhost:YOUR_PORT node server.js
+> ```
+
+### Option B: Run OpenClaw with CORS Headers
+
+If you control your OpenClaw config, you can add CORS headers directly.
+
+---
+
+## Exporting Dashboards
+
+1. Click the **💾 Export** button in the toolbar
+2. Choose **Download Dashboard**
+3. A ZIP file is created containing:
+   - `index.html` - Your complete dashboard
+   - `server.js` - Server for OpenClaw widgets (optional)
+   - Any embedded images
+
+The exported HTML is self-contained and can be:
+- Opened directly in a browser (for non-API widgets)
+- Served via the included Node.js server
+- Hosted on any static web server
+
+---
+
+## Development
+
+### File Structure
+```
+dashboard-builder/
+├── index.html          # Main builder UI
+├── css/
+│   └── styles.css      # Dashboard styles
+├── js/
+│   ├── builder.js      # Builder logic
+│   └── widgets.js      # Widget definitions
+├── server.js    # Node.js server for exports
+└── WIDGETS-STATUS.md   # Widget verification status
+```
+
+### Adding New Widgets
+
+See `js/widgets.js` for widget definitions. Each widget has:
+- `name`, `icon`, `category`
+- `description` - Shows in properties panel
+- `defaultWidth`, `defaultHeight`
+- `properties` - Configurable options
+- `generateHtml()` - Returns widget HTML
+- `generateJs()` - Returns widget JavaScript
+
+---
+
+## License
+
+MIT
+
+---
+
+Made with 🦞 by the LobsterBoard team

package/dist/lobsterboard.css

@@ -0,0 +1,347 @@
+/* LobsterBoard v0.1.0 - Dashboard Styles */
+/* LobsterBoard Dashboard - Generated Styles */
+
+:root {
+  --bg-primary: #0d1117;
+  --bg-secondary: #161b22;
+  --bg-tertiary: #21262d;
+  --bg-hover: #30363d;
+  --border: #30363d;
+  --text-primary: #e6edf3;
+  --text-secondary: #8b949e;
+  --text-muted: #6e7681;
+  --accent-blue: #58a6ff;
+  --accent-green: #3fb950;
+  --accent-orange: #d29922;
+  --accent-red: #f85149;
+  --accent-purple: #a371f7;
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  background: var(--bg-primary);
+  color: var(--text-primary);
+  min-height: 100vh;
+}
+
+.dashboard {
+  margin: 0 auto;
+  overflow: hidden;
+}
+
+.widget-container {
+  overflow: hidden;
+}
+
+/* KPI Cards */
+.kpi-card {
+  background: var(--bg-secondary);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 16px;
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  height: 100%;
+}
+
+.kpi-sm {
+  padding: 12px;
+}
+
+.kpi-icon {
+  font-size: 24px;
+}
+
+.kpi-data {
+  flex: 1;
+}
+
+.kpi-value {
+  font-size: 20px;
+  font-weight: 600;
+}
+
+.kpi-value.blue { color: var(--accent-blue); }
+.kpi-value.green { color: var(--accent-green); }
+.kpi-value.orange { color: var(--accent-orange); }
+.kpi-value.red { color: var(--accent-red); }
+
+.kpi-label {
+  font-size: 12px;
+  color: var(--text-secondary);
+  margin-top: 2px;
+}
+
+.kpi-indicator {
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  background: var(--text-muted);
+}
+
+.kpi-indicator.green { background: var(--accent-green); }
+.kpi-indicator.yellow { background: var(--accent-orange); }
+.kpi-indicator.red { background: var(--accent-red); }
+
+/* Dash Cards */
+.dash-card {
+  background: var(--bg-secondary);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  overflow: hidden;
+}
+
+.dash-card-head {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 12px 16px;
+  border-bottom: 1px solid var(--border);
+  background: var(--bg-tertiary);
+}
+
+.dash-card-title {
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.dash-card-badge {
+  font-size: 11px;
+  color: var(--text-secondary);
+  background: var(--bg-primary);
+  padding: 2px 8px;
+  border-radius: 10px;
+}
+
+.dash-card-body {
+  flex: 1;
+  padding: 12px 16px;
+  overflow-y: auto;
+}
+
+.compact-list {
+  font-size: 12px;
+}
+
+.syslog-scroll {
+  font-family: 'SF Mono', Monaco, monospace;
+  font-size: 11px;
+}
+
+/* Top Bar */
+.topbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 8px 20px;
+  background: var(--bg-secondary);
+  border-bottom: 1px solid var(--border);
+  height: 100%;
+}
+
+.topbar-left {
+  display: flex;
+  align-items: center;
+  gap: 20px;
+}
+
+.topbar-brand {
+  font-weight: 600;
+  font-size: 14px;
+}
+
+.topbar-link {
+  color: var(--text-secondary);
+  text-decoration: none;
+  font-size: 13px;
+}
+
+.topbar-link:hover,
+.topbar-link.active {
+  color: var(--accent-blue);
+}
+
+.topbar-right {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.topbar-meta {
+  font-size: 12px;
+  color: var(--text-muted);
+}
+
+.topbar-refresh {
+  background: var(--bg-tertiary);
+  border: 1px solid var(--border);
+  color: var(--text-secondary);
+  padding: 4px 8px;
+  border-radius: 4px;
+  cursor: pointer;
+}
+
+/* List Items */
+.list-item {
+  padding: 6px 0;
+  border-bottom: 1px solid var(--border);
+}
+
+.list-item:last-child {
+  border-bottom: none;
+}
+
+.cron-item {
+  display: flex;
+  justify-content: space-between;
+  padding: 6px 0;
+  border-bottom: 1px solid var(--border);
+}
+
+.cron-name {
+  color: var(--text-primary);
+}
+
+.cron-next {
+  color: var(--text-muted);
+  font-size: 11px;
+}
+
+.log-line {
+  padding: 2px 0;
+  border-bottom: 1px solid rgba(48, 54, 61, 0.5);
+}
+
+/* Weather */
+.weather-row {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 0;
+  border-bottom: 1px solid var(--border);
+}
+
+.weather-row:last-child {
+  border-bottom: none;
+}
+
+.weather-icon {
+  font-size: 18px;
+}
+
+.weather-loc {
+  flex: 1;
+  color: var(--text-primary);
+}
+
+.weather-temp {
+  font-weight: 600;
+  color: var(--accent-blue);
+}
+
+/* Utilities */
+.loading-sm {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 20px;
+}
+
+.spinner-sm {
+  width: 20px;
+  height: 20px;
+  border: 2px solid var(--bg-tertiary);
+  border-top-color: var(--accent-blue);
+  border-radius: 50%;
+  animation: spin 1s linear infinite;
+}
+
+@keyframes spin {
+  to { transform: rotate(360deg); }
+}
+
+.error {
+  color: var(--accent-red);
+  padding: 10px;
+  text-align: center;
+}
+
+::-webkit-scrollbar {
+  width: 6px;
+}
+
+::-webkit-scrollbar-track {
+  background: var(--bg-primary);
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--bg-tertiary);
+  border-radius: 3px;
+}
+
+/* Post-Export Edit Mode */
+.edit-mode .widget-container {
+  cursor: move;
+  outline: 2px dashed #3b82f6;
+  outline-offset: -2px;
+}
+
+.edit-mode .widget-container:hover {
+  outline-color: #60a5fa;
+}
+
+.edit-mode .widget-container.dragging {
+  opacity: 0.8;
+  z-index: 1000;
+}
+
+.resize-handle-edit {
+  display: none;
+  position: absolute;
+  bottom: 0;
+  right: 0;
+  width: 16px;
+  height: 16px;
+  cursor: se-resize;
+  background: #3b82f6;
+  border-radius: 2px 0 0 0;
+  z-index: 10;
+}
+
+.edit-mode .resize-handle-edit {
+  display: block;
+}
+
+#edit-toggle {
+  position: fixed;
+  bottom: 20px;
+  right: 20px;
+  z-index: 9999;
+  padding: 8px 16px;
+  background: #1e293b;
+  color: white;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  font-size: 13px;
+  font-weight: 500;
+  box-shadow: 0 2px 8px rgba(0,0,0,0.3);
+}
+
+#edit-toggle:hover {
+  background: #334155;
+}
+
+#edit-toggle.active {
+  background: #3b82f6;
+}