| UI or UX | UI + UX - Unbounded loading anti-pattern | UI + UX - Bounded content loading placeholder | UI + UX - Recoverable failure surface |
| UI guidance | Replace an unlabeled endless spinner with a bounded loading surface that names the operation, preserves the affected context, and changes state after the wait threshold. | Render neutral skeleton blocks that reserve the final content structure without fake readable text, fake controls, or focusable placeholder elements. | Render a persistent error region near the affected content with a specific failure heading, plain-language cause, preserved context, and recovery actions. |
| UX guidance | Help users decide whether to wait, retry, leave safely, use stale data, or escalate instead of forcing them to infer system health from animation alone. | Reduce uncertainty and layout shift while predictable content loads, then resolve clearly to real content, empty state, or error state. | Help users recover when expected loading, saving, validation, sync, permission, or computation fails without losing their work. |
| Good UI | Billing data is loading shows the affected account, elapsed wait, and actions for Retry, Use cached values, and Contact support after timeout. | Three report-card placeholders match the final card heights and are replaced by real cards without shifting the panel. | Reports could not load appears in the report section with the saved filter, Retry, Use cached data, and Contact support actions. |
| Bad UI | A centered spinner animates on a blank page for minutes with no label or escape. | Skeleton rows look like clickable report cards and receive focus before content exists. | Tiny transient toast for a blocking failure. |
| Good UX | The user can wait briefly, see that billing data is delayed, open cached values, retry once, or escalate with a reference. | Users see that reports are pending, then can switch the demo to loaded, empty, or error outcomes on a bounded path. | User input and filter context are preserved after failure, and retry returns to recovered content or a clear still-failed state. |
| Bad UX | Users refresh the page because the spinner never explains whether the request is still working or broken. | Skeleton never resolves. | Clearing work after save failure. |
| Best fit | Use this anti-pattern entry to audit loading, saving, syncing, uploading, report generation, billing retrieval, AI generation, and import flows that can hang. | The content shape is predictable. | A system or task failure blocks expected content or action. |
| Avoid when | A short spinner is clearly labeled, tied to a specific action, and guaranteed to transition quickly. | The system cannot predict the content layout. | Nothing exists yet and the state is expected. |
| Required state | Initial pending state that names the operation and affected object. | Initial skeleton placeholder state with region marked busy. | Normal expected state before failure. |
| Accessibility burden | Do not leave a region or page in a permanent busy state after loading has stalled or failed. | Mark the loading region busy or provide concise status text. | Use appropriate alert or status semantics for newly appearing critical errors. |
| Common misuse | Animating a full-page spinner forever after a request times out. | Showing skeletons forever. | Using a transient toast for critical errors. |