Measured entry

hextaui-ai-error-handler

alertminimal-flat

A client-side React alert for AI request failures, with optional dismiss and asynchronous retry actions plus a loading state. It ships as a shadcn registry item and expects local Alert and Button primitives, a cn utility, Tailwind styling, and Lucide icons.

Specimen
Harness screenshot of hextaui-ai-error-handler at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of hextaui-ai-error-handler at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of hextaui-ai-error-handler at 1440 pixels wide
Harness screenshot at 1440 pixels wide. No horizontal overflow recorded.

Measured

Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.

Harness measurements recorded for hextaui-ai-error-handler
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal33.7 KB (99.2 KB build, 65.5 KB baseline)
Bare modeFAIL
Provider requiredNO
Demo usedwritten from the component source API

What the harness recorded

BARE BUILD

✗ Build failed in 692ms
error during build:
[vite]: Rollup failed to resolve import "lucide-react" from "<sandbox>re-c3dee52c42ff/src/cut/blocks/ai/ai-error-handler.tsx".

Verdict

A focused error-state building block with sensible retry behavior and clean accessibility results. It needs a shadcn-style setup and does not mount bare; adopt it when those primitives already exist, but fix the narrow-layout overflow before shipping on mobile.

Use it if

  • You need an inline model-error state with retry and dismiss callbacks.
  • Your app already uses shadcn-style primitives, Tailwind utilities, and path aliases.
  • You want retry progress and repeated-click protection handled inside the component.

Skip it if

  • The alert must fit narrow containers without additional responsive fixes, since the verified mobile view clips horizontally.
  • You need error telemetry, recovery policy, or retry backoff rather than a presentation component.
  • Your design system cannot absorb shadcn Alert and Button markup or Lucide icons.

Install

Installation record for hextaui-ai-error-handler
Declared dependencies@radix-ui/react-slot, @radix-ui/react-separator, clsx, tailwind-merge
Missing on installnone
Bare installfails once the shadcn-style helpers are removed, so it needs that setup
Providerno provider required in the harness

In a non-shadcn project, add equivalent Alert and Button primitives, Lucide React, Tailwind styles, the cn helper backed by clsx and tailwind-merge, the Radix dependencies used by the registry primitives, and aliases for the local imports. Adjust the responsive layout to prevent narrow-container clipping.

Source and credit

This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.

License
MIT
Record published
2026-08-17

Alternatives

Other published entries for the alert pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.