Skip to content

docs: showcase every style and publish usage badges - #1185

Merged
rowkav09 merged 1 commit into
mainfrom
feat/usage-badges-docs
Oct 11, 2026
Merged

rowkav09 merged 1 commit into
mainfrom
feat/usage-badges-docs

Conversation

@rowkav09

Copy link
Copy Markdown
Member

The README now shows all six card styles and three live usage badges, and the hosted service publishes the aggregate sign-in and registration totals that the privacy documentation already describes.

  • Add /badges/pcs.json and /badges/users.json to the hosted service alongside /badges/requests.json. Each serves a Shields endpoint badge for one aggregate total (np:stats:registrations, np:stats:users), cached for five minutes, with a 503 unavailable fallback and nothing per card, per user or per device.
  • Show cards-shown, PCs-registered and people-signed-in badges in the README, linking to the new usage badges documentation.
  • Extend the README showcase to a six-style grid (Classic, Paper and Compact join Studio, Editorial and Hi-Fi).
  • Document the badge endpoints, counters and shields snippets in docs/hosted-upload.md and hosted/README.md; correct the counters list to include the per-day user count.
  • Fix stale docs the redesign left behind: the wiki theme list gains studio, editorial and terminal; the dev-build QA checklist exercises the shipped Appearance section, all six styles and the Include cover art toggle; the Discord wiki points at Settings → Appearance → Card Settings; the troubleshooting page describes the shipped diagnostic headers instead of the closed issue; the docs index gains release notes, ways-to-help and guide skeleton entries; the Classic gallery section now shows music, film and TV using the two showcase SVGs that were committed but never embedded.

Validation:

  • Full test suite, guide-path runs and syntax checks pass locally; platform-specific skips unchanged.
  • New tests cover both badge endpoints (200 shape and caching, POST 405, garbage-counter 503 with no-store) and assert the sign-in counter grows once per GitHub user, never per PC.
  • The committed card SVGs are pinned by test/card-examples.test.js, so embedded examples cannot drift from the renderer.

Deployment: the badges go live when the hosted service deploys after merge; until then the Shields badges fall back to their error state. This PR does not deploy production.

Add /badges/pcs.json and /badges/users.json to the hosted service,
publishing the aggregate registration and sign-in totals the privacy
doc already sanctions. Show the three usage badges in the README and
document the endpoints for self-hosters.

Fix the stale docs the redesign left behind: the wiki theme list, the
dev-build QA checklist, the Discord preview pointer, the troubleshooting
note about shipped diagnostic headers, and the docs index. Show the
Classic film and TV examples that were generated but never embedded,
and show all six styles on the README.
@codecov

codecov Bot commented Oct 11, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

@rowkav09
rowkav09 merged commit 726dc57 into main Oct 11, 2026
22 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant