Dashboard

Build custom dashboards from any data source with local hosting and visual QA loops.

Data Storage

~/dashboard/
├── registry.json           # Dashboard index
├── {name}/
│   ├── config.json         # Layout, widgets
│   ├── data.json           # Current data
│   └── index.html          # Dashboard page

Create on first use: mkdir -p ~/dashboard

Scope

This skill:

• ✅ Generates static HTML dashboards
• ✅ Creates fetch scripts user can run
• ✅ Stores dashboards in ~/dashboard/

User-driven model:

• User specifies data sources
• User provides API credentials via environment
• User runs fetch scripts (cron or manual)
• Skill generates HTML and fetch scripts

This skill does NOT:

• ❌ Access credentials without user providing them
• ❌ Run automated fetches (user's cron runs scripts)
• ❌ Scrape services without user consent

Quick Reference

Topic	File
Data source patterns	sources.md
Visual design rules	design.md
Widget templates	widgets.md

Core Rules

1. User Provides Data

When creating a dashboard:

User: "Dashboard for my Stripe revenue"
Agent: "I'll create a fetch script. Set STRIPE_API_KEY 
        in your environment, then run the script."
→ Generates: ~/dashboard/stripe/fetch.sh
→ User adds to cron: */15 * * * * ~/dashboard/stripe/fetch.sh

2. Architecture

[User's Cron] → [fetch.sh] → [data.json] → [index.html]
                    ↓
              Uses $API_KEY from env

Agent generates scripts. User runs them.

3. Fetch Script Template

#!/bin/bash
# Requires: STRIPE_API_KEY in environment
curl -s -u "$STRIPE_API_KEY:" \
  https://api.stripe.com/v1/balance \
  | jq '.' > ~/dashboard/stripe/data.json

4. Visual QA (Before Delivery)

• Open in browser, take screenshot
• Check: no overlap, readable fonts (≥14px), good contrast
• If issues → fix → repeat
• Only deliver after visual validation

5. Design Defaults

Element	Value
Background	#0f172a (dark) / #f8fafc (light)
Text	#e2e8f0 (dark) / #1e293b (light)
Spacing	16px, 24px, 32px
Corners	8px
KPI	48-72px number, 14px label

6. Security

• Credentials via env vars, never in files
• Dashboards on 127.0.0.1 by default
• No PII in displayed data
• User adds auth if exposing to network