Design Knowledge Base
Community-maintained principles reviewed before publication and retrieved as Agent design constraints.
Form Error State Contract
A form error state contract puts labels, helper text, validation timing, inline errors, error summaries, submit states, server failures, mobile keyboards, and ARIA wiring into one implementable model.
Form errors are not one red component; they combine field contracts, state machines, and recovery paths, and should route to narrower guidance for summaries, accessible feedback, persistent labels, and transactional recovery.95%Interaction Responsive Motionforms / errorsTransactional Form Error Recovery
Error handling in high-trust forms is not about telling users they are wrong. It returns them to a recoverable state where they can continue without re-entering information.
Transactional service error recovery must handle visual placement, screen readers, focus, original input, error copy, and next action together.94%Interaction Responsive Motionfeedback / toastToast vs Inline Feedback
Toast vs Inline Feedback turns a frequent interface judgment into an executable constraint before generation.
Feedback placement should match the object; toast fits short global status, while inline feedback fits fields and local fixes.85%Interaction Responsive Motionwizard / progressWizard Stepper Progress
Wizard Stepper Progress turns a frequent interface judgment into an executable constraint before generation.
Wizards need to show current position, remaining work, reversibility, and save state.85%Interaction Responsive Motioninputs / controlsInput Mode and Control Matching
Controls should match decision shape: toggles for binary, segmented controls for modes, menus for option sets, sliders for continuous values.
The wrong control adds cognitive cost and makes reversibility unclear.82%Interaction Responsive Motionforms / workflowForm Flow and Validation
Forms should follow the user's mental order and provide recoverable feedback at key moments.
Good forms split complex tasks into completeable steps rather than dumping every field at once.82%