Skip to content

✨ Kiosk 'Request a Hive' CTA badge for Twitch streams + channel metadata script - #16241

Merged
clubanderson merged 4 commits into
v5from
feat/twitch-cta-overlay
Nov 2, 2026
Merged

clubanderson merged 4 commits into
v5from
feat/twitch-cta-overlay

Conversation

@clubanderson

@clubanderson clubanderson commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

Closes #16236

Drive Twitch viewers of twitch.tv/hivecommons, /hivecommonsfleet and /hivecommonsmatrix to https://hive.hivecommons.dev/get-started.

What changed

1. Kiosk "Request a Hive" call-to-action badge

  • New package pkg/webassets/kioskcta: renders a bottom-right pill ("🐝 Want this for your repos?" + URL ≥ 22px) with a 110px QR code (go-qrcode, inline data: PNG — fits the hub CSP which forbids inline script/style but allows img-src data:). No inline style= attributes; visibility is purely body.kiosk-cta-on set by the page's boot JS.
  • Spoke dashboard (Activity Monitor + Matrix view): injected at Start() via the <!-- hive-kiosk-cta --> placeholder; configurable with dashboard.kiosk_cta_url / dashboard.kiosk_cta_text. Matrix sits above the canvas at opacity .85.
  • Hub public Fleet page (/activity/public): same badge, configurable with HIVE_HUB_KIOSK_CTA_URL / HIVE_HUB_KIOSK_CTA_TEXT.
  • Shown only with ?kiosk=1; &cta=off hides it. Never visible in the ordinary operator dashboard.
  • Tests: pkg/webassets/kioskcta, pkg/dashboard/kiosk_cta_test.go, pkg/dashboard/kiosk_cta.test.js, pkg/hub/activity_kiosk_cta_test.go (present with kiosk=1, absent otherwise / with cta=off).

2. Twitch channel metadata script

src/scripts/twitch-channel-cta.sh PATCHes helix/channels (title, category "Software and Game Development", tags) for the three channels. set -euo pipefail, idempotent, --dry-run, --only <channel>, verifies the category id via helix/search/categories, never echoes tokens. Not executed — needs a per-channel user token with channel:manage:broadcast (device-code flow documented).

3. Docs

docs/streaming-the-activity-monitor.md: "Call-to-action overlay" and "Channel title, category, tags"; docs/env-vars.md rows; changelog fragment; api-reference citations refreshed (check-api-reference-citations.sh --fix).

Screenshots (1920×1080, local build)

Activity Monitor kiosk:
Activity Monitor kiosk with CTA badge bottom-right

Matrix kiosk (opacity .85, footer text stays bottom-left):
Matrix kiosk with CTA badge

Hub public Fleet page kiosk:
Hub Fleet activity kiosk with CTA badge

Owner follow-ups (manual)

  • Obtain a user token per channel (device-code grant, see doc) and run TWITCH_CLIENT_ID=… TWITCH_CLIENT_SECRET=… TWITCH_TOKEN_HIVECOMMONS=… … scripts/twitch-channel-cta.sh --dry-run, then without --dry-run.
  • Paste the three panel PNGs (artifact, not committed) into each channel's About tab.

…etadata script

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Nov 2, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign danathar for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. label Nov 2, 2026
@github-actions

github-actions Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Open PR overlap check

Base branch: v5

Conflicts are checked with every PR merged onto the current tip of v5, so a PR that only needs a rebase is not reported as conflicting with its siblings.

PR Title Relation Files
#16240 ✨ feat: name the sentinel's flagged paths and rules in the decision dialog and hive comment same files src/pkg/dashboard/static/index.html
#16228 🐛 dashboard: align contributor presence counts and person IDs CONFLICT src/docs/api-reference/dashboard-misc.md
#15890 🐛 dashboard: point operator-reference help marks at the section sub-pages same files src/pkg/dashboard/static/index.html
#16247 ✨ Show the Activity Monitor item count and delta cue in the monitor header same files src/docs/streaming-the-activity-monitor.md
src/pkg/dashboard/static/index.html

@hivecommons-hive

hivecommons-hive Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Hive status — updated in place; edits do not notify. Full history is in the Activity Monitor.

clubanderson this PR is held at stage/071-needs-author and the hive will not merge it yet.

Failing checks:

  • runtime-tests

Next: the hive does not push to your branch. Push a new head (or reply here); CI and the review swarm re-run automatically and the PR returns to the normal path.

Use shared tokens (--fs-xl/--fs-2xl, --r-sm, --shadow-modal, --surface-0,
--text, --brand) instead of raw px/hex values so the operator index.html
style ratchet stays flat; drop the CSS comment that TestMatrixUIWiring
read as an unscoped Matrix selector; allowlist pkg/webassets (shared by
the spoke dashboard and hub Fleet page) in the dashboard import ratchets
with justification.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@clubanderson
clubanderson merged commit ceb80dd into v5 Nov 2, 2026
84 of 85 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the feat/twitch-cta-overlay branch November 2, 2026 16:12
@github-actions

github-actions Bot commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback

clubanderson added a commit that referenced this pull request Nov 2, 2026
Merge v5 8664848 without changing landed scripts. Independently reviewed complete scripts-tree union: all 67 existing entries unchanged; only the two monthly automation files and the byte-identical Twitch script from #16241 are added. Pin exactly 96c95ac. No runtime enrollment, privilege, weekly report source or canonical workflow changes.

Signed-off-by: Andy Anderson <andy@clubanderson.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

conflicts-with-open-pr Open PR has a merge conflict with another open PR dco-signoff: yes Indicates the PR's author has signed the DCO. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Twitch streams: on-screen 'Request a Hive' CTA overlay in kiosk views, channel metadata script and panel assets

1 participant