Skip to content

cta · Canvas 2D

FlintButton

A button that strikes like flint: a steel rakes the stone and throws sparks, and enough heat makes it catch.

Button that strikes like flint: a steel rakes the stone and throws sparks; heat builds until it catches

  • Canvas 2D
  • Reduced motion: static
  • 3.13 KB gzip
  • Layout shift 0
View the source Spec sheet as Markdown

Install

Install
pnpm dlx shadcn@4.21.1 add @frictionborn/flint-button

Playground

Click it, or rub across the stone fast: enough heat makes it catch.

Palette
Your code
import { FlintButton } from "@/components/ui/flint-button";

<FlintButton>
  Strike
</FlintButton>

In a full example

The full example loads as you scroll to it.

Accessibility

  • A native <button> with its text label (which becomes litLabel while it burns). The optional heat status under it is aria-live=polite. The spark canvas and the steel are aria-hidden. Sparks last under 3 s per strike.
  • Keyboard: A native <button>: Enter and Space strike, focus ring visible
  • Touch: Tap strikes
  • WCAG criteria it is built for: 2.1.1, 2.4.7, 4.1.2, 4.1.3

Props

PropTypeDefaultWhat it does
childrenReact.ReactNodenoneRequired. The button's label while cold.
litLabelReact.ReactNode"Lit"The label while the stone burns.
statusText{ cold: string; warm: string; hot: string; burning: string } | null"{ cold: \"Cold stone\", warm: \"Warm\", hot: \"Hot\", burning: \"Burning\" }"Visible heat status under the button (aria-live polite); null hides it.
onClickReact.MouseEventHandler<HTMLButtonElement>noneYour action; runs on every strike.
palette"fire" | "ice" | "neon" | "mono" | "custom""fire"Colours of the effect (DESIGN.md A8). custom reads --fb-heat-0..4 from the page.
pausedbooleanfalseUniversal pause prop: the effect stops drawing; the control keeps working.
maxTiernumber3Hard ceiling on the capability tier.
noncestringnoneCSP nonce for the component's <style> element.
classNamestring""Extra classes on the root.
styleReact.CSSPropertiesnoneInline styles on the root, merged after the palette variables.
refReact.Ref<HTMLButtonElement>noneReceives the <button>; className, style and the rest of the props go on the button too.

Measured on the bench

Measured by the automated bench at commit 801163e on 2026-10-21. These numbers are written by the bench, never by hand.

MeasureResult
Size, gzip3.13 KB at load, 0.02 KB loaded later
Layout shift0
Frames when nothing should moveoff screen 0, hidden tab 0, reduced motion 0
axe accessibility scan0 serious, 0 critical

Browsers it ran in

Automated Playwright runs, some with device emulation. Results from physical phones and tablets are still pending, so none are listed.

EnvironmentTierResultDateNotes
Chromium Desktop (SwiftShader)3pass2026-10-2116 passed, 0 failed
Chromium Mobile (Pixel 7 emulation)2pass2026-10-2115 passed, 0 failed
Firefox Desktop3pass2026-10-2114 passed, 0 failed
WebKit Desktop3pass2026-10-2115 passed, 0 failed
WebKit Mobile (iPhone 14 emulation)2pass2026-10-2115 passed, 0 failed

On different devices

Reduced motion (static): A plain stone button: no steel, no sparks, no glow, no canvas. Clicks work as usual.

TierWhat it does
T3 FullEffect on a canvas at DPR <= 2 with the full particle count
T2 StandardEffect on a canvas at DPR <= 1.5 with half the particles
T1 LiteSame as tier 2
T0 StaticThe control alone (server render, reduced motion, Save-Data, no WebGL2): no canvas

Content Security Policy

  • Works without 'unsafe-eval'.
  • Uses the reveal gate ([data-motion="ok"]): render <MotionReadyScript /> in <head> (with your nonce), or call initMotionReady() in Vite.
  • Sets inline style attributes, so allow style-src-attr 'unsafe-inline'.

Goes well with