city-dashboard-brisbane

Imported from z3d/city-dashboard-brisbane (AGENTS.md). Install upstream with npx skills add z3d/city-dashboard-brisbane. Copyright stays with the author.

City Dashboard

Single-file city dashboard focused on Brisbane, deployed optionally as a Cloudflare Worker.

Commands

• npm run dev - local Cloudflare Worker at http://localhost:8787
• npm run deploy - deploy with Wrangler
• node scripts/check-ios12-compat.js - scan index.html for iOS 12-incompatible JavaScript
• node --check src/worker.js - syntax-check the Worker
• npm run validate - run the complete local validation suite
• Or open index.html directly in a browser for features that do not require the Worker

Architecture

index.html              # Single-file dashboard, source of truth for frontend
src/worker.js           # Cloudflare Worker API proxy routes
public/index.html       # Symlink to ../index.html; do not replace with a copy

iOS 12 Safari Compatibility

index.html must stay compatible with iOS 12 Safari:

• No arrow functions; use function() {}
• No let or const; use var
• No template literals
• No for...of
• No destructuring, spread, rest, optional chaining, or nullish coalescing
• No Promise.allSettled, Object.entries, or Array.flat
• Use XMLHttpRequest, not frontend fetch()
• Run node scripts/check-ios12-compat.js after frontend JavaScript changes

Worker code in src/worker.js runs on Cloudflare's V8 runtime and may use modern JavaScript.

Data And Privacy

This public fork is intended to be generic. Do not add personal integrations, hardcoded device names, home proxy URLs, credentials, tokens, or private account identifiers.

The birthday feature must ship with birthdays: []. Names and dates are user-entered local settings and must never be added to source defaults or examples. Per-birthday timezones use the allowlisted IANA names in COMMON_TIMEZONES.

Before publishing or pushing, scan for secrets and identifying data:

rg -n "token|secret|password|api[_-]?key|email|github.com/.+/.+|workers.dev|AIza|sk-" .
git status --short

Keep .dev.vars, .env, .Codex/settings.local.json, .codex/settings.local.json, and .claude/ ignored.

Patterns

• Config is stored in config and persisted to localStorage with the brisbane_ prefix.
• DOM elements are cached in elements from initElements().
• New cards must be added to DEFAULT_CARD_ORDER.
• Card display modes use xxxDisplayMode with card, ticker, banner, or both.
• Escape all third-party API text at the HTML sink with escapeHtml(); use safeDomId() for API-derived element IDs.
• Frontend XHRs inherit a 30-second timeout and same-URL GET deduplication. Worker upstream requests inherit a 20-second deadline. Preserve both wrappers.
• Needs Attention is a global smart strip controlled by showNeedsAttention and needsAttentionMaxItems. It renders in #needsAttention, uses enabled feature toggles as eligibility, and builds alerts from cached last*Data/config without extra API fetches. It currently excludes bin and sports alerts, and only treats electricity as attention-worthy when prices are high.
• Weather alert banners must never fire on the first feed snapshot. Re-baseline silently after a processing gap longer than 15 minutes so sleeping wall displays do not replay stale transitions when they wake.
• /api/feed-health is per-isolate, read-only observability populated by the central response wrapper. It must not write KV or add upstream requests.
• Bin card conditional dismissal can sync through GET/PUT /api/dashboard-status when the worker has a STATUS_KV or SETTINGS_KV binding. It falls back to the existing localStorage keys: binTakenOutDate hides the pre-collection card until the bring-in window, while binDismissedDate hides the bring-in "Done" state.
• Radar/Satellite conditional display depends on weather data: bomRadarShowWhenRainy and radarShowWhenRainy use weather codes or 50%+ rain chance. fetchWeather() must still run for these conditions even when the Weather card is off.
• Module-level Worker caches are load reducers, not cross-isolate rate limiters. Quota-limited upstreams must use a shared KV cache.
• DASHBOARD_TOKEN is mandatory for every API route except /api/health, and authentication must keep using timingSafeEqual().
• Open-Meteo timestamps should use timeformat=unixtime and parse with new Date(timestamp * 1000).
• Electricity prices use the Worker /api/electricity route. NEMWEB removed the old GRAPH_5QLD1.csv feed; parse the latest DispatchIS_Reports/PUBLIC_DISPATCHIS_*.zip and QLD1 DISPATCH,PRICE RRP instead. The card graph reads /api/electricity/history (AEMO 5MIN report, module cache only — a 5-min KV key would cost 288 puts/day), fetched at most every 5 minutes by fetchElectricityHistory().
• Every ticker slide in buildTickerSlides() must carry a cardId (or newsIdx for headlines): tapping a ticker/status-strip reading clones that card's .card-inner into #cardPopupOverlay (showCardPopup), finance opens its spotlight. validate-project.js fails on an untagged slide.
• Ticker sparklines: a slide's optional spark (plain numbers) and sparkClass render through tickerSparkHtml(). Finance uses /api/finance history (a month of daily closes, which also supplies the day-change reference); fuel uses the Worker's fuel_hist_* KV record (one point per 6h per station set, ~4 puts/day, skipped without a KV binding).

Adapting Another City

Fork the repo, then give it to an LLM coding agent with the target city's requirements. Ask it to update coordinates, transit APIs, waste collection data, radar/satellite defaults, electricity market, airport/flight bounding box, copy, docs, and deployment notes.