Keyboard Interaction Primitives
Give every menu, list, and dialog the same keyboard behaviour instead of ad hoc handlers.
What it adds
A shared set of keyboard behaviours for activation, dismissal, roving movement, and typeahead, adopted by the app's existing interactive components.
What your agent is told to do
5
What your agent is told to do
5-
1
Inventory every component in the app that already listens for key presses — menus, comboboxes, tab strips, trees, dialogs, table rows, date pickers — and record which keys each one currently handles and how they disagree.
-
2
Settle on one behaviour per pattern: Enter and Space activate, Escape dismisses the nearest layer, arrow keys move within a group, Home and End jump to the ends, and printable characters start a typeahead that resets after a short idle period.
-
3
Move focus with a single roving tabstop per group so the whole group is one tab stop from outside, and make the currently focused item the only one reachable by Tab.
-
4
Route dismissal through a layer stack so Escape closes the topmost thing only — a popover inside a dialog inside a fullscreen view must unwind one layer at a time.
-
5
Do not reimplement behaviour the browser already provides on native controls. Re-binding arrow keys on a real select, textarea, or link steals behaviour users rely on and usually breaks assistive technology; the announcement side of these interactions belongs to Live Region Manager, not here.
Edge cases it handles
7
Edge cases it handles
7- Native elements come with keyboard behaviour already — links, buttons, selects, radio groups, and text inputs must keep it, so the primitives have to detect a native target and stand aside rather than intercept.
- Input Method Editors compose characters over several key presses, and acting on Enter or Escape mid-composition destroys the word being typed; suppress activation and dismissal while a composition is in progress.
- Platform shortcuts collide with anything the app claims — Command and Control combinations, browser find, and screen reader pass-through modes — so single unmodified keys are safer than combinations, and anything that overlaps a system binding must be dropped.
- Interactive elements nest: a menu item containing a delete button, a table row containing a link. Decide which level owns the key press, stop propagation deliberately, and make sure the inner control is reachable without breaking the outer group's arrow movement.
- Typeahead must not fire while focus is inside a text field, or typing a search term will jump the selection somewhere unexpected.
- A group whose items are virtualized cannot move focus to an element that is not rendered; scroll the target into existence first, then focus it.
- Disabled and hidden items must be skipped by arrow movement rather than focused and silently ignored, which strands the user pressing the same key repeatedly.
Definition of done
8
Definition of done
8- Every interactive group in the app responds to Enter, Space, Escape, arrows, Home, and End the same way.
- Each group is a single tab stop from outside, with a roving tabstop inside it.
- Escape closes only the topmost layer, and nested layers unwind one press at a time.
- No key handler fires during text composition or while focus sits in a text field, except the field's own behaviour.
- Native controls retain their browser-provided keyboard behaviour unmodified.
- Arrow movement skips disabled and hidden items and works in virtualized lists.
- The feature matches the existing design system.
- No existing functionality is broken.
Related features
Screen Reader Only Utility
Screen Reader Only Utility
One tested way to add text for assistive technology without it appearing on screen.
What it does
A single visually hidden utility used for labels, instructions, and context that assistive technology needs and sighted users do not.
How it works
- 1 Find every place the app currently hides text from sight — off-screen positioning, zero dimensions, transparent colour, tiny font sizes, aria-label strings duplicating nearby copy — and consolidate them onto one utility.
- 2 Build it by clipping the element to nothing while keeping it rendered and in the accessibility tree: it must occupy no visual space and contribute nothing to layout, yet still be read in document order.
- 3 Provide a second variant that becomes visible when it receives focus, and use it for skip links and any other hidden content that is itself focusable.
Copy the prompt
No account needed
Add this feature to my app:
https://addthisfeature.com/x/screen-reader-only-utility
Avatar Group
Avatar Group
Show who is involved in a compact space without a pile of broken images.
What it does
A stacked set of member avatars with deterministic ordering, an overflow count, and access to the full list.
How it works
- 1 Find the places that show several people at once — assignees, collaborators, workspace members, comment participants — and render them through one grouped component.
- 2 Order the stack deterministically by a stable rule such as role then name, so the same group renders in the same order on every load and every device.
- 3 Cap the number shown and collapse the remainder into a single count that is announced meaningfully, not as a bare number sitting after a row of pictures.
Copy the prompt
No account needed
Add this feature to my app:
https://addthisfeature.com/x/avatar-group
Progress Indicator System
Progress Indicator System
Tell people how far along the work is, in the same way every time.
What it does
A consistent set of bars, rings, step trackers, and accompanying text for work that takes measurable time.
How it works
- 1 Identify every operation in the app that takes long enough to need feedback — uploads, imports, exports, batch actions, multi-step flows — and decide for each whether its progress is genuinely measurable.
- 2 Use a determinate form only when a real proportion is known. Where the total is unknown, use an indeterminate form and say what is happening in words rather than inventing a percentage.
- 3 Pair every indicator with text that names the operation and its current position, so the information survives for someone who cannot see the graphic.
Copy the prompt
No account needed
Add this feature to my app:
https://addthisfeature.com/x/progress-indicator-system
How it works
-
1
Copy the link
Grab the Markdown instruction URL for this feature.
-
2
Give it to your AI
Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.
-
3
It inspects, then implements
Your agent reads your existing app first, then adds the feature to fit it.
Works with your stack
These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.
Need it tighter than that? Customize the feature and tell it exactly what you're running.