SKILL.md
User Experience & Feedback
Implement cross-cutting feedback and perceived-performance patterns in Hotwire.
Core Workflow
- Identify feedback need: loading, submit activity, progress reporting, optimistic updates, or transitions.
- Prefer built-in Turbo semantics first (
busy, progress bar hooks, submit/render lifecycle events). - Add optimistic updates only with a clear reconciliation strategy.
- Keep transition logic bounded to explicit lifecycle events and cache/preview-safe paths.
- Verify UX behavior on slow network, back/forward cache restores, and submission failures.
Guardrails
- Do not use fixed timeouts as a proxy for network or render completion.
- Gate animations/transitions for previews and cache restores.
- Keep submit locking/unlocking symmetric between start and end events.
- Separate UX feedback logic from domain-specific form/media/navigation implementations.
Load References Selectively
Open only the file needed for the current request.
- Turbo progress bar reuse:
references/2023-07-18-turbo-drive-progress-bar.md - Form activity indicators:
references/2023-06-06-turbo-drive-form-activity-indicators.md - Render interception and page transitions:
references/2023-04-25-turbo-drive-render-interception.md - Swiper-like transition behavior:
references/2024-11-19-turbo-drive-swiper-view-transitions.md - Frame busy spinner patterns:
references/2026-01-20-turbo-frames-loading-spinner.md - Optimistic UI with Turbo morph reconciliation:
references/2024-03-26-optimistic-ui-with-turbo-8-morphs.md - ULID-based optimistic identity strategy:
references/2024-08-13-turbo-drive-ulid.md
Use references/INDEX.md for the full catalog.
Escalate to Neighbor Skills
- Form validation and submit correctness concerns: use
hwc-forms-validation - Navigation/history/cache flow concerns: use
hwc-navigation-content - Real-time push updates and stream actions: use
hwc-realtime-streaming - Media-specific playback/upload concerns: use
hwc-media-content - General Stimulus API/controller fundamentals: use
hwc-stimulus-fundamentals