Theme SwitchFreev1.0.0
One key on its plate that switches light and dark: the sun's rays retract and a mask cuts the core into a crescent, and the page sweeps to the new theme behind a 1px signal line, from the side of the change.
Live preview
Installation
Base UI
pnpm dlx shadcn@latest add https://beautiful-ui.dev/r/theme-switch.jsonRadix
pnpm dlx shadcn@latest add https://beautiful-ui.dev/r/radix-nova/theme-switch.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @beautiful-ui registry added, @beautiful-ui/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (Source below, or save them all as a .zip)
- components/ui/notchset/theme-switch.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { ThemeSwitch, type ThemeName } from "@/components/ui/notchset/theme-switch";
/** With next-themes: const { resolvedTheme, setTheme } = useTheme(), and pass those instead. */
export function ThemeToggle() {
const [theme, setTheme] = React.useState<ThemeName>("light");
React.useEffect(() => {
document.documentElement.classList.toggle("dark", theme === "dark");
}, [theme]);
return <ThemeSwitch theme={theme} onThemeChange={setTheme} />;
}Props
theme / onThemeChange–"light" | "dark" / (theme) => voidControlled, e.g. with next-themes' resolvedTheme and setTheme.
defaultTheme–"light" | "dark"Uncontrolled start. Without either, it reads and toggles the dark class on <html> and saves the choice under localStorage "theme".
label–stringThe key's label. Default "SWITCH THEME".
iconOnly–booleanA 40×40 key.
sweep–booleanThe View Transitions sweep. Default true; instant without support or under reduced motion.
labels–{ toDark?, toLight? }The accessible names.
Source
components/ui/notchset/theme-switch.tsx
Loading the code
