Knowledge RAG
Submit principleDesign Knowledge Base
Community-maintained principles reviewed before publication and retrieved as Agent design constraints.
3 published principles / 192 in library
Frontend Implementationaria / components
ARIA Component Contract
Before styling a custom interactive component, define its native-first decision, name/role/value, ARIA/DOM states, keyboard matrix, focus path, visual states, and test assertions.
ARIA is not a magic semantic layer for divs; a component is implementable only when native semantics, keyboard behavior, accessible name, state attributes, and visual state agree.96%Frontend Implementationcomponents / statesComponent State Matrix Contract
Before generating or adopting a component, define the state matrix, triggers, ARIA/DOM expression, visual tokens, and test path instead of only shipping the static default state.
Component quality is not the default-state screenshot. Every reachable state must remain understandable, recoverable, and testable across mouse, keyboard, touch, screen readers, loading, errors, and permission limits.95%Interaction Responsive Motionfeedback / statesFeedback States for System Continuity
Loading, saving, generating, review, and failure all need visible states so users know the system is responding.
Missing feedback causes repeated clicks or fear that data was lost.82%