Focus timer
Focus timer drawn as a ring of 60 pixels; one breaks loose each interval and drops into a sand pile, and reset flies them back.
Playground
Change a prop and the component updates. Props marked live animate to the new value; the others rebuild the element.
<PxFocus duration={60} />Installation
pnpm dlx shadcn@latest add @lumesec/px-focusFirst 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-focus.jsonUsage
import { PxFocus } from "@/components/lumesec/px-focus";
export function Example() {
return (
<PxFocus duration={60} />
);
}Behaviour
Sixty pixels make the ring. Each second the next one trembles, breaks loose and drops into a sand pile below. Reset and the whole pile flies back up into place.
API reference
Attributes
durationReact propdurationTypenumberDefault60Session length in seconds, split evenly across the 60 ring pixels; a missing, invalid or non-positive value uses 60. A change applies immediately, also to a running session.
Events
Events bubble and cross the shadow boundary unless the description says otherwise.
startReact proponStartDetail{}Fires when the timer starts or resumes.
pauseReact proponPauseDetail{}Fires when the timer is paused.
resetReact proponResetDetail{}Fires when the timer is reset.
doneReact proponDoneDetail{}Fires when the last pixel falls and the session is complete.
Methods
Call them on the element, for example through a React ref.
toggle()Starts, pauses or resumes the timer; after completion it resets instead.
reset()Stops the timer and flies the fallen pixels back into the ring.
Properties
durationTypenumberSession length in seconds; reflects the duration attribute, 60 when it is missing, invalid or not positive.
Accessibility
- The remaining time and the status (Ready, Focus, Paused, Session complete) are text in a
role="timer"element witharia-live="off", so the countdown is not announced on every tick. - The ring canvas is decorative and hidden from assistive technology.
- Start/Pause/Resume and Reset are native buttons.
- Reduced motion: the next pixel no longer trembles before it drops and the completion sparks are skipped; falling and returning pixels still animate.
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 --foreground, --lumesec, --lumesec-success and --muted-foreground.
To restyle only LumeSec elements, set the matching --ui-* overrides: --ui-accent, --ui-fg, --ui-font, --ui-mono, --ui-muted and --ui-ok.
Notes
- The timer keeps time from the clock, so a session runs on in a hidden tab or off screen and
donefires on time; the ring catches up when it is drawn again. - The canvas is a fixed 224 by 232px; the time sits in the centre of the ring in the monospace font.
Related
Was this page helpful?