Typing heatmap
Typing test over a pixel keyboard where each key flashes, ripples to its neighbours, builds heat with use and turns red on a miss.
Installation
pnpm dlx shadcn@latest add @lumesec/px-keysFirst timeRegister the @lumesec registry once, or install by URL
Adds @lumesec to your components.json:
pnpm dlx shadcn@latest registry add @lumesec=https://elements.lumesec.ai/r/{name}.jsonOr skip the setup and install by URL:
npx shadcn@latest add https://elements.lumesec.ai/r/px-keys.jsonUsage
import { PxKeys } from "@/components/lumesec/px-keys";
export function Example() {
return (
<PxKeys />
);
}Behaviour
A typing test over a pixel keyboard. Each key flashes and ripples to its neighbours, builds up heat the more you use it, and turns red on a miss.
API reference
Events
Events bubble and cross the shadow boundary unless the description says otherwise.
doneReact proponDoneDetail{ wpm: number, accuracy: number }Fires when the typed text matches the target line. accuracy is a whole percentage.
Methods
Call them on the element, for example through a React ref.
reset()Clears the input, the timer, the score and the key heat, makes the field editable again and focuses it.
Keyboard
| Keys | Action |
|---|---|
| Printable characters (in the input) | Flash the matching key and count the keystroke; a wrong character flashes red and lowers accuracy. |
Accessibility
- The target line is read as one piece of visually hidden text, "Type this: pixels glow when you type them"; the coloured characters are
aria-hidden. The input hasaria-label="Typing test"and is described by the target line. - The keyboard canvas has
role="img"andaria-label="Keyboard heatmap". - The WPM and accuracy line updates silently while you type; a visually hidden
aria-live="polite"region announces the result once the line is complete. The input then turns read-only and keeps focus; Reset is a native button. - Reduced motion: only the completion sparks and the rolling status text are suppressed; key flashes and ripples still play.
Theming
The element reads your shadcn theme tokens through its shadow root, so light and dark follow your theme. The accent comes from --lumesec. See Theming.
This component reads --border, --card, --destructive, --foreground, --lumesec, --lumesec-success and --muted-foreground.
To restyle only LumeSec elements, set the matching --ui-* overrides: --ui-accent, --ui-border, --ui-danger, --ui-fg, --ui-mono, --ui-muted, --ui-ok and --ui-surface.
Notes
- The target sentence is fixed demo content. WPM counts correct keystrokes divided by five per minute from the first key.
- The heatmap covers letters and the space bar; the key letters are drawn in the page font. Reset also clears the key heat. The canvas is 104px tall.
Related
Was this page helpful?