GlassKit UI
Components

StatusDot

A glanceable sensor / permission / connection indicator. With one accent on the lens, state reads from luminance + motion: on = steady, live = pulsing, off = dim.

GPS lockMic readyOffline
600 × 600 · live

Installation

npx @glasskit-ui/cli add status-dot

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.tsexport type ClassValue = string | number | null | undefined | false;/** * Join truthy class names. Dependency-free on purpose: the lens components * style via bespoke semantic classes (no conflicting Tailwind utilities to * de-dupe), so this needs no clsx/tailwind-merge and resolves from anywhere * the registry is vendored. */export function cn(...inputs: ClassValue[]): string {  return inputs.filter(Boolean).join(" ");}/** * 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/status-dot.tsximport type { ReactNode } from "react";import { cn } from "../lib/utils";/** * <StatusDot> — a glanceable sensor / permission / connection indicator. The * lens has one accent, so state reads from luminance + motion, not a second * hue: `on` = steady accent, `live` = pulsing accent, `off` = dim. */export function StatusDot({  status = "on",  label,  className,}: {  /** Semantic state — live pulses, off dims. */  status?: "on" | "live" | "off";  label?: ReactNode;  className?: string;}) {  return (    <span className={cn("gk-statusdot", `gk-statusdot--${status}`, className)}>      <span className="gk-statusdot__dot" />      {label != null ? (        <span className="gk-statusdot__label t-caption">{label}</span>      ) : null}    </span>  );}

Usage

<StatusDot status="live" label="GPS lock" />

Props

Prop

Type