A collection of beautifully designed, accessible, and customizable terminal UI components. Built on Ink and OpenTUI. Works with shadcn/ui.

How do I publish components with termcn?

Add or edit components under registry/bases/ink/ or registry/bases/opentui/, register them in registry.json, run pnpm registry:build (which refreshes public/r/), then deploy. Consumers install with npx shadcn@latest add against your published registry URL.

Is termcn open source?

Yes. The source is on GitHub and released under the MIT License.

Timer

Countdown timer with pause/resume and auto-start

Ink OpenTUI

Terminal

                                                                               █
 timer-demo                                                                    █
 Loading preview...                                                            █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █
                                                                               █

Installation


$ pnpm dlx shadcn@latest add @termcn/opentui/timer

Usage

import { Timer } from "@/components/ui/timer";

<Timer duration={300} format="ms" label="Pomodoro" autoStart />

API Reference

Timer

Prop	Type	Default
`duration`	`number`	`required`
`onComplete`	`() => void`	-
`autoStart`	`boolean`	`false`
`format`	`"hms" \| "ms" \| "s"`	`"hms"`
`color`	`string`	-
`label`	`string`	-

Stopwatch Toggle

On This Page

Installation Usage API Reference Timer

Edit this page Follow @shadcnlabs Join community