Liquid Circular Timer

A production-scale, light + dark Liquid Circular Timer component. Copy-paste via the CLI; you own the code.

npx lerpa-cli add liquid-circular-timer

Live preview available in the gallery.

Usage

import { LiquidCircularTimer } from "@lerpa/ui";

<LiquidCircularTimer />

Props

Prop	Type	Default	Description
initialSeconds	number	—
className	string	—

Accessibility

Keyboard accessible interactive elements.
Respects prefers-reduced-motion where animated.
Color is never the only signal.

Overview

The Liquid Circular Timer component is a UI component in Lerpa UI's 1318-item shadcn-compatible registry, built for React 19 and Tailwind CSS v4. It exposes 2 configurable props, documented in the table below. It builds on framer-motion, lucide-react. Install it once with the CLI and the source is written into your project as a file you own — read it, edit it, or remove it, with no version to lock.

Install options

Add Liquid Circular Timer with the Lerpa CLI, or with the shadcn CLI pointed at the registry URL — the source is shadcn-compatible, so either tool writes the same file.

# Lerpa CLI
pnpm dlx lerpa-cli add liquid-circular-timer

# shadcn-compatible
npx shadcn add https://lerpaui.com/r/liquid-circular-timer.json

Dependencies

framer-motion
lucide-react

Related components

Browse the full component gallery.