For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
/
144
Sponsor

Checkbox

A checkbox whose checked/unchecked state is a pure function of the timeline.

Customize

Installation

$ pnpm dlx shadcn@latest add @framecn/checkbox

Usage

import { Checkbox } from "@/components/ui/checkbox";
<Checkbox label="Accept terms and conditions" state="checked" />

Smooth transitions

The docs preview animates checked → unchecked via useCheckboxTransition. Forward primary into the hook when using style so the fill tracks the color prop:

import { Checkbox } from "@/components/framecn/checkbox";
import { useCheckboxTransition } from "@/components/framecn/use-checkbox-transition";
 
const style = useCheckboxTransition(
  [
    { at: 18, state: "checked", duration: 14 },
    { at: 78, state: "unchecked", duration: 12 },
  ],
  { primary: "#171717" }
);
 
<Checkbox label="Accept terms and conditions" style={style} />;

style takes precedence over state when both are provided.

API Reference

Checkbox

PropTypeDefault
state"unchecked" | "checked""unchecked"
styleCheckboxStyle- (takes precedence over state)
labelstring-
size"sm" | "default" | "lg""default"
themePartial<FramecnTheme>-
primarystring-
align"start" | "center" | "end""center"
classNamestring-