dashboard — HTML Admin dashboard Template

SHA-256: 43263b67708f1d05079b23aae740c520b8fc90a56fbb614e5f444102acf897dc

2026-10-03T07:19:44.353Z

<div align="center">

# Dashboard

![MIT](https://img.shields.io/badge/license-MIT-00e879?style=flat-square)
![Runtime](https://img.shields.io/badge/runtime-static%20HTML-42f4c8?style=flat-square)
![Dependencies](https://img.shields.io/badge/dependencies-zero--deps-39ff8c?style=flat-square)
![Mode](https://img.shields.io/badge/mode-local--first-00e5ff?style=flat-square)

**Make one dashboard. For everyone.** ✨

Choose SEO, finances, health, or pets; edit local JSON; get a polished standalone dashboard. No
account, backend, telemetry, API key, package install, or network connection is required.

</div>

---

## See it first

| SEO | Finances | Health | Pets |
|---|---|---|---|
| ![SEO Dashboard](docs/screenshots/hero/1920/seo-1920.png) | ![Finance Dashboard](docs/screenshots/hero/1920/finances-1920.png) | ![Health Dashboard](docs/screenshots/hero/1920/health-1920.png) | ![Pets Dashboard](docs/screenshots/hero/1920/pets-1920.png) |
| Aurora SEO | Emerald Finance | Vitality Health | Dusk Companion |

The example HTML files under `profiles/` open directly from `file://` and use fictional data. They
have no required CDN, remote font, or remote chart runtime.

## Quick start

Download or clone the repository, then choose a workflow.

### Local wizard

On Windows, double-click `Dashboard.cmd`. On macOS or Linux, use:

```bash
npm run dashboard
```

The temporary wizard runs only on `127.0.0.1`, edits the output folder you choose, and shuts down
when you press **Stop** or it becomes idle. Its forms and raw-JSON editor use the same validation and
update core as the command line.

### Command line

```bash
git clone https://github.com/jenninexus/dashboard.git
cd dashboard
npm run build-dashboard -- --profile seo --name "Your Name"
```

Then edit `my-dashboard/data.json`, rebuild only the embedded data region, and open the result:

```bash
npm run dashboard:update -- --out my-dashboard
```

The updater validates the profile contract, preserves custom HTML/CSS outside the generated data
block, and keeps one rotating `dashboard.html.bak`. It never treats `--force` as an update path and
never rewrites `data.json`.

## Profiles

| Profile | Tracks | Default theme |
|---|---|---|
| **SEO** | GA4 · Search Console · PageSpeed · Cloudflare | `aurora-seo` |
| **Finances** | cash · bills · deadlines · payment history · action plan · loans · income | `emerald-finance` |
| **Health** | vitals · meds · labs · habits · sleep | `vitality-health` |
| **Pets** | weight · quality of life · fluids · red flags | `dusk-companion` |

Each profile owns four public files: its renderer, fictional example, routing manifest, and compact
versioned editor contract. See [profiles/README.md](profiles/README.md) for the exact format.

The finances profile is a customizable snapshot, not a payment ledger. It adds bill-tracker
helpers on top of the snapshot:

- **Autopay escalation** — autopay badges go calm → amber at ≤7 days → pulsing rose at ≤3 days
  (static under reduced motion); a passed autopay date stays *unconfirmed* until you log it.
- **Auto priority alerts** — generated from overdue/near bills and deadlines, listed after your
  hand-written alerts.
- **Urgency-sorted deadlines** — most overdue first, then soonest.
- **Append-only payment history** — `npm run fin:history` appends an entry and refreshes the page.
- **ACTION-PLAN.md checklist** — `npm run fin:action-plan` syncs a Markdown plan into a checklist
  with archive/restore.

See [docs/finances-profile.md](docs/finances-profile.md) for the scope, thresholds and data fields. For printable pet-care sheets,
use [jenninexus/senior-pet-care](https://github.com/jenninexus/senior-pet-care).

### Optional AI commands (finances)

`.claude/commands.example/` ships three example commands for AI coding assistants that read
`.claude/commands/`: `dash-fin-start.md.example`, `dash-bills.md.example` and `dash-ap-done.md.example`
(they become `/dash-fin-start`, `/dash-bills` and `/dash-ap-done` once copied). Because of the `.example`
suffix, no assistant loads them until you copy them in. They are templates, not live commands,
and they operate only on this template's example finance data (`profiles/finances/example-data.json`, or
your own copy built into `my-dashboard/`) — they are unrelated to any private finance workspace. The
`dash-` prefix keeps them from colliding with commands you may already have.
To use them in your own clone, copy them and drop the `.example` suffix (the destination is gitignored, so your edits stay local):

```bash
mkdir -p .claude/commands && for f in .claude/commands.example/*.md.example; do cp "$f" ".claude/commands/$(basename "$f" .example)"; done
# Windows PowerShell: New-Item -ItemType Directory -Force .claude/commands; Get-ChildItem .claude/commands.example/*.md.example | ForEach-Object { Copy-Item $_ (Join-Path .claude/commands $_.BaseName) }
```

## Themes

`themes/manifest.json` is the public theme catalog. It lists default/compatible profiles and the CSS
files shipped by each theme. Profile defaults remain intentionally distinct; alternates include
Plasma Green, Aurora Borealis, and Midnight Blue.

The committed CSS is the complete public runtime contract. A generated dashboard never imports a
private kit or machine-local path.

## Privacy and safety

- `data.json`, generated HTML, exports, and `dashboard.html.bak` are unencrypted plaintext files.
- Generated dashboards, local plans, secrets, agent state, and QA captures are gitignored.
- Profile examples are fictional. Do not use real financial, health, analytics, or pet records as
  fixtures, screenshots, issues, or documentation.
- Browser-local theme, collapse, and checklist state is disposable and is not included in JSON
  backups.

The exact public/local boundary is documented in
[docs/PUBLIC-LOCAL-SPLIT.md](docs/PUBLIC-LOCAL-SPLIT.md).

## Repository map

| Path | Purpose |
|---|---|
| `profiles/` | Four domain renderers, examples, manifests, and editor contracts |
| `themes/` | Public theme CSS and compatibility manifest |
| `scripts/` | Shared core, CLI, local wizard, boundary check, and optional capture wrapper |
| `docs/images/` | Runtime art referenced by profiles and copied into generated output |
| `docs/screenshots/hero/` | Curated four-image README gallery only |
| `configs/` | Portable optional screenshot-capture configuration |

Full breakpoint captures are local QA evidence, not public documentation assets.

## Verify or contribute

```bash
npm test
npm run profiles
npm run check:public-boundary
```

Keep changes static, offline-capable, fictional, and profile-specific. A new profile must include all
four profile files, safe text rendering, contract tests, and documentation for any new behavior.

More detail: [getting started](docs/getting-started.md) ·
[profile system](docs/profile-system.md) · [architecture](docs/architecture.md) ·
[finances profile](docs/finances-profile.md)

MIT — use, fork, customize.

---

<div align="center">

[Star this repo](https://github.com/jenninexus/dashboard) · [jenninexus.com/links](https://jenninexus.com/links)

Made with 💚 by [Jenni](https://github.com/jenninexus) at [Monofinity Studio](https://github.com/monofinitystudio)

</div>