Components
Analytics dashboard
Give operators time-bounded readership context with transparent readiness and data freshness.
On this page
Purpose and placement
Give operators time-bounded readership context with transparent readiness and data freshness.
Anatomy
| Part | Behavior |
|---|---|
| Summary | Visitors and pageviews. |
| Traffic chart | Daily points for the selected range. |
| Breakdowns | Pages, routes, referrers, devices, countries, browsers and operating systems. |
| Context | Range, update time, warnings and provider readiness. |
Configuration and contract
| Input or decision | Implementation |
|---|---|
| Dashboard model | status ready / missing_config / error; today / 7d / 30d ranges. |
| Traffic | label, visitors and pageviews per point. |
| Ranked entries | label and value, with optional destination. |
| Capture | Fixed synthetic seven-day data; no real performance/traction claim. |
States and feedback
- Ready populated dashboard and chart specimens.
- Missing configuration and error branches are source-defined but not captured as provider outcomes.
Usage rules
- Keep range and freshness close to totals.
- Do not compare values across different ranges without labeling the difference.
- Treat charts as operational context, not a marketing proof of readership.
Accessibility and verification
Chart.js canvas needs an equivalent textual/data interpretation and clear range labels. Review contrast and keyboard access to range/filter controls; visual chart coverage alone is insufficient.
Source references
| File | Responsibility |
|---|---|
| components/admin/admin-analytics-dashboard.tsx | Audited Townwell implementation; use this file when extending this interface. |
| components/admin/admin-traffic-chart.tsx | Audited Townwell implementation; use this file when extending this interface. |
| lib/vercel-web-analytics.ts | Audited Townwell implementation; use this file when extending this interface. |
Examples from the app
Actual Boise Today and Townwell UI with synthetic editorial, business, review, media metadata and analytics. Existing Boise imagery; no live data changes. Captured at 2× resolution or higher. Select an image to inspect it full size.
Related topics
Source audit: 2026-10-07 · Revision ce8bc72b96da · Documentation v0.1