docs: Document dashboard-change propagation #16

Merged

ahmad merged 1 commit from feat/sync-all-dashboards into main

2026-08-16 20:12:27 +00:00

ahmad commented

2026-08-16 20:01:26 +00:00

Owner

What

A sync-all-dashboards workflow (manual dispatch) that triggers every app's
Monitoring workflow at once, so they all re-render the current @v3 dashboard.

Why

The template is single-sourced here, but each app pushes it from its own
Monitoring workflow — so a template change + v3 tag move doesn't reach
already-pushed dashboards until each app re-runs. This makes that fan-out one
click instead of dispatching each repo by hand.

Notes

App list = DASHBOARD_APPS repo variable (space-separated owner/repo;
defaults to trip/imamah/portfolio). Needs a DASHBOARD_SYNC_TOKEN repo secret
(a PAT that can trigger those repos' workflows).
README documents the propagation flow + that pushes overwrite UI edits.
Verified YAML valid.

Operator setup (one-time)

Set on platform-actions: secret DASHBOARD_SYNC_TOKEN (PAT), optional variable
DASHBOARD_APPS.

### What A `sync-all-dashboards` workflow (manual dispatch) that triggers every app's Monitoring workflow at once, so they all re-render the current `@v3` dashboard. ### Why The template is single-sourced here, but each app pushes it from its own Monitoring workflow — so a template change + `v3` tag move doesn't reach already-pushed dashboards until each app re-runs. This makes that fan-out one click instead of dispatching each repo by hand. ### Notes - App list = `DASHBOARD_APPS` repo variable (space-separated `owner/repo`; defaults to trip/imamah/portfolio). Needs a `DASHBOARD_SYNC_TOKEN` repo secret (a PAT that can trigger those repos' workflows). - README documents the propagation flow + that pushes overwrite UI edits. - Verified YAML valid. ### Operator setup (one-time) Set on platform-actions: secret `DASHBOARD_SYNC_TOKEN` (PAT), optional variable `DASHBOARD_APPS`.

ahmad added 1 commit

2026-08-16 20:01:26 +00:00

feat: Add sync-all-dashboards workflow cc72fca5ac

The standard dashboard is single-sourced here but each app pushes it from
its own Monitoring workflow, so a template change (and a v3 tag move) does
not reach already-pushed dashboards until each app re-runs. This workflow
dispatches every app's Monitoring workflow in one click, turning the drift
window into one action. App list is the DASHBOARD_APPS variable; it needs a
DASHBOARD_SYNC_TOKEN PAT. README documents the propagation flow.

ahmad merged commit 5a1df8e6be into main

2026-08-16 20:12:27 +00:00

ahmad deleted branch feat/sync-all-dashboards

2026-08-16 20:12:27 +00:00

ahmad referenced this pull request from a commit

2026-08-16 20:12:27 +00:00

feat: Add sync-all-dashboards workflow (#16)

ahmad changed title from ~~feat: Add sync-all-dashboards workflow~~ to docs: Document dashboard-change propagation

2026-08-16 20:15:47 +00:00

ahmad referenced this pull request

2026-08-16 20:16:29 +00:00

fix: Move dashboard fan-out out of platform-actions #17