[codex] add starkzap stats dashboard example

[welttowelt]

Summary

This PR adds a new static dashboard example named Starkzap Stats under examples/starkzap-stats/.

The dashboard tracks npm downloads for the starkzap package with four views:

• Daily downloads
• Weekly aggregates (ISO week)
• Monthly aggregates
• Cumulative downloads

Why this change

A dedicated stats page was requested to monitor package adoption trends over time and to make weekly/monthly/cumulative movement immediately visible in one place.

Root cause / gap

The repository currently has no built-in example focused on npm adoption metrics. Existing examples cover app integrations, but there was no download analytics dashboard that can be run quickly as a standalone static page.

Implementation details

• Added examples/starkzap-stats/index.html
  • Uses npm downloads API (https://api.npmjs.org/downloads/range/...) for live data.
  • Computes daily/weekly/monthly/cumulative series in-browser.
  • Applies a visual style aligned with the starkzap.io design language.
  • Uses a fixed start date of 2026-02-01 and automatically sets end date to today's local date.
• Added examples/starkzap-stats/README.md
  • Documents metrics, date range behavior, and local run instructions.

User impact

Developers and maintainers can now run a local dashboard quickly to inspect package growth trends without external setup. This improves visibility into adoption and release impact over time.

Validation

• Pre-commit checks passed during commit:
  • npm run typecheck
  • npm run lint
  • npm run prettier:check
• Script syntax in dashboard validated before commit.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 1dae9f6d-325f-4e15-b395-f905cfca2732

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}