Repository navigation
docs(design): selection bubble, quick insert and slash menu design - #124
Merged
6 commits merged intoNov 17, 2026
Merged
6 commits merged into
6 commits merged into
Conversation
Audit of today's bubble, Insert, "/" and phone surfaces with screenshots, research across eight editors and the platform guidance, and a design for owner review: owner decisions O1-O12, the bubble without registerPlugin, the "/" menu amendments and a phased plan.
A clickable throwaway prototype with a switch for each owner decision, theme, RTL, reduced motion and device, plus its screenshots.
…ert-design # Conflicts: # CHANGELOG.md
This was referenced Nov 17, 2026
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
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
This is a design for the owner's review: the selection bubble, quick insert and the "/" menu. It has an audit of today's UI, research, a spec with owner decisions, and a clickable prototype. It is documentation only; no app, server or test code changes.
docs/superpowers/specs/2026-11-17-bubble-and-quick-insert-design.md. §2 lists every decision.docs/design/2026-11-17-bubble-quick-insert-prototype.html. Download it and open it locally. It has a switch for each decision (O1, O2, O4–O7, O11, O12), theme, RTL, reduced motion, device, document kind, and a Today / Proposed comparison.docs/design/2026-11-17-bubble-quick-insert/current/(today,main@f9cfc3a) anddocs/design/2026-11-17-bubble-quick-insert/proposed/(the prototype, 25 states).References:
Decisions to approve (spec §2), highest leverage first
registerPluginfrom its lazy chunk. Today's React<BubbleMenu>breaks the AGENTS rule and rebuilds every plugin view after the chunk lands.canComment()is true.+on the empty line instead of a desktop bottom pill.What the reviews corrected
Three independent reviews (UX, UI and accessibility, staff engineering) ran on the first draft. All their findings are folded in. Three of my own claims were wrong or overstated:
registerPlugincost is real but modest. Measured: 0 of 29 plugin views were reused, andupdateStatetook 0.5 ms. ButEditorContentalready rebuilds the views on every tab switch. The bubble adds one late rebuild; it is not a performance problem.oklch(0.80)on white is 1.87:1. 1.4.11 now rests on the focus ring (7.8:1) and the pressed bar, and the dark bubble gets its own surface.@docs.plusHyperlink package. In v1 it opens below the selection, never over it. Changing the side is a request to the package.Screenshots
Not in this PR
superpowers:writing-plansplan (spec §15, phases P0–P5).Test plan
next dev: Chromium; desktop 1280 px, phone 390 and 320 px, tablet 820 px; light and dark.registerPluginclaim was measured with a temporary Playwright probe, which is not committed.🤖 Generated with Claude Code