GlassKit UI
Primitives

ErrorState

A recoverable error screen: optional glyph, title, message, and a retry action. No red: the lens has one accent, so the failure reads from the words. Pairs with AsyncView's error slot.

No signal

Move to an open area and try again.

Installation

npx @glasskit-ui/cli add error-state

Install the SDK (it provides GlassViewport, useDpad and the stylesheet), then copy these files into your project:

npm install @glasskit-ui/react
// components/lib/utils.tsimport { clsx, type ClassValue } from "clsx";import { twMerge } from "tailwind-merge";export type { ClassValue };/** * Merge class names the shadcn way: clsx joins conditionals, tailwind-merge * de-dupes conflicting Tailwind utilities so a consumer's `className` override * wins (e.g. passing `px-2` beats the component's `px-6`). Lens components are * Tailwind utilities + `--gk-*` tokens, so this de-dupe matters. */export function cn(...inputs: ClassValue[]): string {  return twMerge(clsx(inputs));}/** * Accessible name from a free-form `label` prop: the label itself when it's a * plain string, otherwise undefined (a ReactNode can't become an aria-label). */export function stringLabel(label: unknown): string | undefined {  return typeof label === "string" ? label : undefined;}
// components/glasskit/button.tsximport type { ReactNode } from "react";import { cn } from "../lib/utils";/** * <Button> — a D-pad-focusable action. Renders a real <button> carrying * the `focusable` class, so `useDpad()` includes it in spatial navigation * and activates it on Enter/Space (the hook calls `.click()`, which fires * `onClick`). `primary` wears the accent fill; `positive`/`danger` carry the * semantic accept/destroy fills (calls, irreversible confirms); `ghost` is * chrome-less (just text + focus ring + press) for toolbars and icon rows. */export function Button({  children,  variant = "secondary",  icon,  disabled,  onClick,  type = "button",  initialFocus = false,  "aria-label": ariaLabel,  className,}: {  /** The label. Omit for an icon-only button, but then set `aria-label`. */  children?: ReactNode;  variant?: "primary" | "secondary" | "ghost" | "positive" | "danger";  /** Optional leading glyph — typically a <Icon>. */  icon?: ReactNode;  disabled?: boolean;  onClick?: () => void;  type?: "button" | "submit" | "reset";  /** Seed the D-pad ring here when the screen mounts (`data-autofocus`). */  initialFocus?: boolean;  /** Accessible name — required for an icon-only button. */  "aria-label"?: string;  className?: string;}) {  return (    <button      type={type}      disabled={disabled}      onClick={onClick}      aria-label={ariaLabel}      data-autofocus={initialFocus || undefined}      className={cn(        "focusable press-scale t-body inline-flex items-center justify-center gap-2 rounded-2xl",        variant === "primary"          ? "btn-primary"          : variant === "positive"            ? "btn-positive"            : variant === "danger"              ? "btn-danger"              : variant === "ghost"                ? "bg-transparent border-0 text-foreground"                : "surface",        !children ? "p-[13px] [&_svg]:size-[22px]" : "px-6 py-4",        className,      )}    >      {icon}      {children}    </button>  );}
// components/glasskit/error-state.tsximport type { ReactNode } from "react";import { cn } from "../lib/utils";import { Button } from "./button";/** * <ErrorState> — a recoverable error screen: optional glyph + title + message + * a retry action. No red (the lens has one accent); the failure reads from the * words and a dimmed treatment. Drop it into a <Screen> stage, or use it as the * `error` slot of <AsyncView>. */export function ErrorState({  title = "Something went wrong",  message,  icon,  onRetry,  retryLabel = "Retry",  className,}: {  title?: ReactNode;  message?: ReactNode;  /** Optional leading glyph — typically a <Icon>. */  icon?: ReactNode;  onRetry?: () => void;  retryLabel?: ReactNode;  className?: string;}) {  return (    <div      className={cn(        "flex flex-col items-center gap-3.5 text-center",        className,      )}    >      {icon}      <p className="t-title">{title}</p>      {message != null ? (        <p className="t-body max-w-[30ch] text-muted-foreground">{message}</p>      ) : null}      {onRetry ? (        <Button variant="primary" onClick={onRetry}>          {retryLabel}        </Button>      ) : null}    </div>  );}

Usage

<ErrorState  title="No signal"  message="Move to an open area and try again."  onRetry={refetch}/>

Props

PropTypeDefaultDescription
titleReactNode"Something went wrong"The headline.
messageReactNodeSupporting detail.
iconReactNodeOptional leading glyph.
onRetry() => voidShows a retry button when set.
retryLabelReactNode"Retry"Retry button label.

On this page