skills/wondelai/skills/microinteractions

microinteractions

SKILL.md

Microinteractions Framework

A systematic approach to designing the tiny, contained product moments that users interact with every day -- toggles, password fields, loading indicators, pull-to-refresh, like buttons. Based on Dan Saffer's four-part structure (Trigger, Rules, Feedback, Loops & Modes), this framework turns invisible details into the polish that separates forgettable products from beloved ones.

Core Principle

The difference between a product you tolerate and a product you love is almost always in the microinteractions. A microinteraction is a contained product moment built around a single use case: changing a setting, syncing data, setting an alarm, picking a password. They are so small that users rarely think about them consciously -- but they feel them. Every microinteraction follows the same four-part structure: a Trigger initiates it, Rules determine what happens, Feedback shows what is happening, and Loops & Modes define its long-term behavior.

Scoring

Goal: 10/10. When reviewing or creating microinteractions, rate them 0-10 based on adherence to the principles below. A 10/10 means every interactive moment has a deliberate trigger, clear rules, immediate feedback, and thoughtful loop/mode behavior. Lower scores indicate gaps to address. Always provide the current score and specific improvements needed to reach 10/10.

The Microinteraction Structure

Six areas of focus for designing world-class microinteractions:

1. Triggers

Core concept: The trigger is what initiates a microinteraction. It can be manual (user-initiated -- a tap, click, swipe, voice command) or system-initiated (a condition is met -- time, location, incoming data, error state). The trigger is the front door of every microinteraction.

Why it works: Without a clear trigger, users cannot discover or initiate the interaction. Without a system trigger, the product cannot respond to changing conditions. Well-designed triggers make functionality discoverable and set accurate expectations for what will happen next.

Key insights:

  • Manual triggers live inside existing UI controls: buttons, switches, icons, form fields, gestures
  • System triggers fire automatically when conditions are met: time elapsed, threshold reached, data received
  • A trigger must communicate three things: that it exists, what it does, and what state it is in
  • Trigger affordance should match the importance of the action -- high-stakes actions need prominent triggers
  • Invisible triggers (gestures, shake, proximity) must be paired with a visible alternative for discoverability
  • Trigger states -- default, hover, active, disabled, loading -- must be visually distinct

Product applications:

Context Application Example
Toggle controls Manual trigger with binary state iOS Wi-Fi switch: tap to toggle, position shows state
Pull-to-refresh Hidden gesture trigger with visible affordance Pulling down past threshold triggers refresh animation
System alerts System trigger on condition met Low battery notification at 20% threshold
Search fields Manual trigger with auto-suggest system trigger Typing initiates search; results appear as system trigger
Hover reveals Manual trigger using proximity Toolbar actions appear on card hover

Ethical boundary: Never hide critical triggers behind gestures or invisible interactions without a visible fallback. Users should always be able to discover essential functionality.

See: references/trigger-design.md

2. Rules

Core concept: Rules determine what happens once a microinteraction is triggered. They define the sequence of events, the constraints on what can and cannot happen, the algorithm that processes input, and when the microinteraction ends. Rules are the invisible logic -- users never see them directly, but they feel when rules are wrong.

Why it works: Rules create the mental model users build about how the interaction works. When rules are consistent and match expectations, the interaction feels natural. When rules violate expectations -- a toggle that does not toggle, a slider that jumps in value -- users lose trust.

Key insights:

  • Define the goal of the microinteraction first, then derive rules from it
  • Rules should feel natural -- match existing mental models and platform conventions
  • Constrain inputs to prevent errors: limit character counts, set value ranges, enforce formats
  • Handle edge cases explicitly: what happens at zero, at maximum, on repeated triggers, on interruption
  • Simple rules produce complex-feeling interactions; complex rules produce confusing interactions
  • The best rules are invisible -- users do not think about them, they just work

Product applications:

Context Application Example
Password strength Rules evaluate input in real-time Meter updates as user types; color shifts from red to green
Character counter Rule constrains and displays remaining Twitter/X: counter decreases, turns red at limit
Volume control Rule maps input to output with constraints Slider snaps to 5% increments; long-press mutes
Shopping cart Rules manage quantity and state Cannot go below 1; shows "max 10" at limit
Undo action Rule sets time window for reversal Gmail "Undo send" available for 30 seconds

Ethical boundary: Rules should be transparent and predictable. Do not create hidden rules that manipulate user behavior, such as making unsubscribe require more steps than subscribe.

See: references/rules-and-state.md

3. Feedback

Core concept: Feedback communicates the rules of the microinteraction to the user. It answers: "What is happening right now?" Feedback can be visual (color, animation, movement), auditory (clicks, chimes), or haptic (vibrations). The key constraint is showing only what matters -- minimal, meaningful, contextual.

Why it works: Without feedback, users cannot tell if their action registered, if the system is working, or if the operation succeeded. Feedback closes the Gulf of Evaluation. Too little feedback creates anxiety; too much creates noise. The right feedback at the right time makes interactions feel responsive, trustworthy, and alive.

Key insights:

  • Feedback must be immediate -- under 100ms for direct manipulation
  • Use the least noticeable feedback that still communicates: a subtle color change before a modal dialog
  • Feedback should map to the significance of the event: small action = small feedback, big result = big feedback
  • Visual feedback is primary; audio and haptic are supplementary and should never be the only channel
  • Progress indicators reduce perceived wait time even when actual time stays the same
  • Feedback should use existing elements when possible -- animate the button, not a separate notification

Product applications:

Context Application Example
Button press Visual state change on click Button depresses, color shifts, text changes to "Saving..."
Form validation Inline feedback as user types Green checkmark appears next to valid email field
File upload Progress indicator with percentage Progress bar fills; percentage and estimated time shown
Error state Contextual error near the source Red border on field + message "Password must be 8+ characters"
Success confirmation Brief, non-blocking affirmation Checkmark animation replaces submit button for 1.5 seconds

Ethical boundary: Feedback should be honest. Do not use fake progress bars, manipulative countdown timers, or deceptive completion percentages to create false urgency.

See: references/feedback-patterns.md

4. Loops and Modes

Core concept: Loops determine the meta-rules of a microinteraction -- what happens over time. Does the interaction change after the 100th use? Does it expire? Does it adapt? Modes are forks in the rules -- temporary states where the microinteraction behaves differently (e.g., edit mode vs. view mode).

Why it works: Products that never evolve feel stale. Products that shift behavior unpredictably feel unreliable. Thoughtful loops let microinteractions mature gracefully -- reducing friction for power users while remaining discoverable for new ones. Modes, when used sparingly, let a single control serve multiple purposes without cluttering the interface.

Key insights:

  • Open loops continue until explicitly stopped (a repeating alarm); closed loops run once and end (a timer)
  • Long loops change the microinteraction over time: first use might show a tooltip; 50th use does not
  • Progressive reduction: strip away scaffolding as users demonstrate mastery
  • Modes are dangerous -- they violate the principle that the same action should produce the same result
  • If you must use modes, make the current mode extremely visible (Caps Lock indicator, edit mode banner)
  • Avoid mode errors by minimizing the number of modes and making mode transitions deliberate

Product applications:

Context Application Example
Onboarding tooltips Long loop removes hints after N uses First 3 sessions show "Swipe to archive"; then stop
Alarm clock Open loop repeats daily until disabled Alarm fires every weekday at 7am until toggled off
Text editing Mode: view vs. edit Banner reads "Editing" with a "Done" button to exit mode
Smart defaults Long loop learns preferences Email app learns you always CC your manager; suggests it
Notification frequency Long loop adapts delivery Reduces notifications if user ignores 5 in a row

Ethical boundary: Loops should benefit the user, not the business. Do not use adaptive loops to increase notification frequency or make opt-outs progressively harder.

See: references/loops-modes.md

5. Signature Moments

Core concept: A signature moment is a microinteraction so distinctive that it becomes part of the product's identity. It transforms a functional necessity into a brand-defining detail -- the Facebook Like thumbs-up, the iPhone slide-to-unlock, Slack's loading messages. Not every microinteraction should be a signature moment, but every product should have one or two.

Why it works: Signature moments create emotional memory. They make products feel crafted rather than assembled. When users describe your product to others, signature moments are what they demonstrate first. They turn utility into personality.

Key insights:

  • Signature moments work best on frequent, visible actions -- not buried settings
  • They must be functional first, delightful second -- never sacrifice usability for novelty
  • Animation, sound, and copy are the three most common tools for creating signature moments
  • Signature moments should align with brand personality: playful brands get playful moments
  • Restraint matters -- if everything is a signature moment, nothing is
  • Test whether users would miss the detail if it were removed; if not, it is decoration, not signature

Product applications:

Context Application Example
Social reaction Animated response to engagement Facebook Like: thumbs-up animates with particles
Loading state Branded waiting experience Slack: rotating quotes during load
Completion Celebratory confirmation Stripe payment: animated checkmark with confetti
Empty state Personality in absence of content Dropbox: illustrated scenes with friendly copy
Error recovery Graceful failure with personality GitHub 404: parallax Octocat illustration

Ethical boundary: Signature moments should never obscure important information or delay the user to show off an animation. Function always precedes delight.

See: references/signature-moments.md

6. Reducing and Simplifying

Core concept: The best microinteraction is one the user barely notices because it is so simple and fast. Reduction means doing less -- fewer options, fewer steps, fewer decisions. Simplifying means making what remains feel effortless. The goal is to distill every microinteraction to its absolute essence.

Why it works: Every option, field, and decision adds cognitive load. Users do not want to configure a toggle switch. They want the toggle to work. Reduction fights feature creep at the smallest level. The most elegant microinteractions have zero configuration, one action, and immediate results.

Key insights:

  • If a microinteraction needs instructions, it is too complex
  • Remove options by choosing smart defaults -- pick the best choice and commit to it
  • Collapse multi-step interactions into a single action where possible
  • Use progressive disclosure: show simple first, reveal complexity only when requested
  • Avoid "settings within settings" -- if a microinteraction has its own preferences, reconsider
  • The number of rules should be proportional to the frequency of use: common actions need few rules

Product applications:

Context Application Example
Smart defaults Eliminate configuration Camera app defaults to photo mode, not settings
Inline editing Remove modal, edit in place Spreadsheet cell: click to edit, Enter to save
Auto-detection System handles instead of user Credit card type detected from first digits
Single action One tap replaces multi-step flow Double-tap to like instead of open menu, select reaction
Anticipatory design Predict and pre-fill Shipping form pre-fills city and state from ZIP code

Ethical boundary: Simplification should not remove user control over meaningful choices. Do not auto-opt users into features that benefit the business at the user's expense.

See: references/trigger-design.md for reducing trigger complexity.

Common Mistakes

Mistake Why It Fails Fix
No feedback on action Users do not know if their tap registered Add immediate visual state change to every interactive element
Overdesigning simple moments Complex animations slow down frequent actions Reserve rich animation for infrequent, high-impact moments
Ignoring edge cases Interaction breaks at zero, at max, or on double-tap Map every state: empty, loading, partial, full, error, disabled
Invisible triggers Users cannot discover functionality Pair gesture triggers with a visible alternative
Mode errors Same action produces different results depending on hidden state Make current mode visible; minimize number of modes
Ignoring long loops Interaction feels the same on day 1 and day 100 Use progressive reduction to streamline for returning users
Feedback overload Every action triggers a toast, sound, or animation Use the smallest feedback that communicates; reserve big feedback for big events
Fake progress indicators Users feel deceived when they discover the bar is fake Use honest, deterministic progress; show indeterminate spinner when unknown

Quick Diagnostic

Audit any microinteraction:

Question If No Action
Is there a clear, discoverable trigger? Users cannot initiate the interaction Add a visible control or affordance
Does the trigger show its current state? Users cannot tell if it is on, off, or loading Add distinct visual states for every trigger state
Are the rules simple and predictable? Users are confused by what happened Simplify rules; match platform conventions
Is there immediate feedback? Users question whether their action worked Add visual response within 100ms
Does feedback match the significance of the event? Small actions feel dramatic or big actions feel trivial Scale feedback to match event importance
Does the interaction evolve over time? Power users are still seeing beginner hints Add progressive reduction through long loops
Is the interaction free of unnecessary modes? Users perform wrong action in wrong mode Remove modes or make current mode highly visible
Could a first-time user figure it out without help? Interaction needs explanation Simplify or add a one-time hint via long loop

Reference Files

  • trigger-design.md: Manual and system triggers, trigger affordances, trigger states, invisible trigger design, placement and visibility
  • rules-and-state.md: Defining rules, state management, constraints, error states, edge cases
  • feedback-patterns.md: Visual, audio, and haptic feedback, timing, progressive disclosure, preventing overload
  • loops-modes.md: Open and closed loops, long loops, modes, mode errors, progressive complexity
  • signature-moments.md: Brand-defining microinteractions, examples, when to invest, making mundane interactions delightful
  • case-studies.md: Detailed design breakdowns of form submission, toggle/switch, pull-to-refresh, loading states, and notifications

Further Reading

This skill is based on Dan Saffer's definitive guide to designing the details that separate good products from great ones:

About the Author

Dan Saffer is a designer, author, and design leader who has led design teams at Twitter, Jawbone, and Smart Design. He is known for his work on interaction design at the detail level -- the small, contained moments that make up the bulk of user experience. Microinteractions codified a framework that design teams at companies worldwide use to audit, design, and improve the small details that make products feel polished and alive. Saffer has also authored Designing for Interaction and Designing Gestural Interfaces, and he speaks regularly at design conferences on the craft of interaction design.

Weekly Installs
136
Repository
wondelai/skills
GitHub Stars
213
First Seen
Feb 23, 2026
Installed on
codex129
opencode128
cursor126
gemini-cli126
github-copilot126
amp125