Introduction

Cult UI is a shadcn/ui registry of animated, niche components: AI prompt inputs, Halo form controls, shader heroes, device mockups, illustrations, and more. Every component is plain React and Tailwind CSS source that you add to your project with the shadcn CLI, then own and edit like the rest of your code.

How it works

Cult UI is not an npm package. It is a registry that the shadcn CLI already knows about under the @cult-ui namespace.

When you run npx shadcn@latest add @cult-ui/halo-button, the CLI:

1. Copies halo-button.tsx into your components/ui folder.
2. Installs the npm packages it needs, such as motion and @base-ui/react.
3. Adds any shadcn/ui components it builds on, such as button or badge.

There is no Cult UI runtime and nothing to keep in sync. Components use your shadcn theme tokens (bg-card, text-muted-foreground, ring-ring), so they pick up your colors, radius, and dark mode.

Quick start

In a React project that already uses shadcn/ui:

pnpmnpmyarnbun
Copy
pnpm dlx shadcn@latest add @cult-ui/halo-button

Copy
import { HaloButton } from "@/components/ui/halo-button"
 
export default function Page() {
  return <HaloButton>Get started</HaloButton>
}

New project, or not using shadcn/ui yet? Start with Installation.

Where to go next

FAQ