Relay Button | Sean Lynch

Made of something. A restrained oxblood rim around recessed, scan-lined green glass. Live monospace text stays crisp.

The moment. Hover prepares a short interference pass. Press seats the display and briefly resolves into a confirmation label.

Yours to adapt. Copy the component source, styles and materials. Functional text stays live, effects respect reduced motion, and the artwork requires no remote hosting.

Try it

Press to send a signal and watch the display resolve.

Install

Add it with the shadcn CLI, or copy the source manually.

Release candidate: public installation becomes available after deployment. Use an existing React 19 project with shadcn initialized and a components.json file. The CLI installs the source, CSS, embedded materials, MIT licence and font notices together.

Terminal

npx shadcn@latest add https://seanportfol.io/r/grimkit-relay-button.json

Prefer a namespace? Register the registry once.

Terminal

npx shadcn@latest registry add @seanlynch=https://seanportfol.io/r/{name}.json

Terminal

npx shadcn@latest add @seanlynch/grimkit-relay-button

Usage

Copy this example into a separate file, not over the installed component. The @/ alias points to your source root. In Next.js this is a Client Component; Vite also accepts the directive. Replace demonstration actions with your application logic.

components/examples/relay-button-demo.tsx

"use client";

import { useState } from "react";
import { RelayButton } from "@/components/grimkit/relay-button";

export default function Example() {
  const [saved, setSaved] = useState(false);
  return <>
    <RelayButton confirmedLabel="Acknowledged" onClick={() => setSaved(true)}>
      Save changes
    </RelayButton>
    <p role="status">{saved ? "Demo changes saved in memory." : "Unsaved changes."}</p>
  </>;
}

API Reference

Props on Relay Button. Consult the included TypeScript source for supported native attributes.

PropTypeDefault

childrenLive button label.ReactNodeSave changes

confirmedLabelBrief post-click display label. The caller still owns the save operation.stringChanges saved

onClickNative click handler; preventDefault suppresses local acknowledgement.MouseEventHandler<HTMLButtonElement>–

disabled / type / nameStandard button semantics and form support.Native button attributes–

classNameAdditional class on the control surface; does not replace the material styles.string–

effectsAuto honours reduced motion; off disables decorative motion and particles."auto" | "off""auto"

Information

Category: GrimKit
Files: components/grimkit/relay-button.tsx
components/grimkit/core.tsx
components/grimkit/foundation.css
components/grimkit/materials.css
components/grimkit/modern-foundation.css
components/grimkit/modern-relay-button.css
components/grimkit/modern-relay-display.css
components/grimkit/LICENSE.txt
components/grimkit/Saira-OFL.txt
components/grimkit/JetBrainsMono-OFL.txt
Dependencies: React 19 and React DOM 19; no additional runtime packages
Compatibility: React 19, TypeScript, CSS imports, Modern browsers
Version: 0.2.0
Updated: Sep 22, 2026
Registry: grimkit-relay-button