feat(frontend): in-app "what's new" release-notes panel#12
Merged
Conversation
Add a top-bar What's-new button (next to the theme toggle) that opens a modal with bundled, curated release notes. An unread dot shows while the running version (from /api/v1/info, normalized) has not been acknowledged, and the modal auto-opens once per version jump without stacking on an already-open modal. Notes ship with the frontend (content/changelog.ts) so there are no runtime network calls; last-seen state lives in localStorage. Signed-off-by: FinkeFlo <florian.kube@gmail.com>
… notes The auto-opening modal's backdrop intercepted pointer events and broke the Playwright e2e harness, whose build reports version "e2e-dev" (normalized "e2e") with no matching changelog entry. Gate the unread dot and the auto-open on the running version having a CHANGELOG entry, so dev builds, the e2e harness, and any version without notes neither nag nor block automation. Manual open via the top-bar button still works for any version. Signed-off-by: FinkeFlo <florian.kube@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a top-bar "What's new" control that opens a modal with curated,
bundled release notes. An unread dot shows while the running version has
not been acknowledged, and the modal auto-opens once per version jump.
Design spec + plan live in the private deploy repo
(
docs/superpowers/{specs,plans}/2026-07-09-whats-new-*).What it does
unread dot while the running version is unseen.
already-open modal (
anyModalOpen()guard); the dot is the fallback entry.Feature/Fix/Securitybadges.Design decisions
(
src/content/changelog.ts) — no runtime network calls, no externallinks, no PR references. Fits the stateless single-binary / air-gapped CF
deployment.
/api/v1/info,normalized (
normalizeVersionstrips a leadingvand-btp/-local/-dev),so the indicator fires on every image bump. Last-seen state in
localStorage.<Modal>,lucide-react, TanStack Query).Backend
None. Uses the existing
/api/v1/infoversion. NoTODO(backend)items.Release follow-up (cross-repo)
Add a checklist step to
scripts/release-and-deploy.sh(deploy repo):append a
CHANGELOGentry whoseversionequals the normalized release tagbefore tagging. Optionally a CI check asserting
CHANGELOG[0].versionmatches the tag prevents drift.
Gates
npm run lint✓npm run build✓npm run check:palette✓whats-new.ts,WhatsNewModal,WhatsNewButton).