Installation

Every component installs as source code you own. Pull it in with one CLI command, or copy the files by hand.

ShitUI — an open-source collection of animated React components.

Every component installs as source code you own. Pull it in with one CLI command, or copy the files by hand.

With the CLI

1. Run the add command

Use the official shadcn CLI to pull the component source directly into your codebase with zero setup:

npx shadcn@latest add https://shitui.in/r/liquid-button.json

Swap liquid-button for any component. On pnpm, bun, or yarn, run:

# pnpm
pnpm dlx shadcn@latest add https://shitui.in/r/liquid-button.json

# bun
bunx --bun shadcn@latest add https://shitui.in/r/liquid-button.json

# yarn
yarn dlx shadcn@latest add https://shitui.in/r/liquid-button.json

Using the @shitui shortcut: If you prefer the short syntax npx shadcn@latest add @shitui/liquid-button, add the registry to your components.json:

{
  "registries": {
    "@shitui": "https://shitui.in/r/{name}.json"
  }
}

2. Import and use it

Render it like any other React component:

import { LiquidButton } from '@/components/shitui/LiquidButton';

export default function App() {
  return <LiquidButton>Click me</LiquidButton>;
}

By hand

1. Open a component's Code tab

Browse any component in the catalog. Click the Code tab in the preview bar to view the full source code.

2. Copy the files into your project

Create a new file in your project, for example components/shitui/LiquidButton.tsx, and paste the component code.

3. Add the utility helper

Ensure you have the standard cn helper in @/lib/utils.ts:

import { clsx, type ClassValue } from 'clsx';
import { twMerge } from 'tailwind-merge';

export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}

4. Install its dependencies

ShitUI animations are powered by Motion (motion/react):

npm install motion clsx tailwind-merge

5. Import and use it

Import and render it the same way as the CLI example above.

That's all

The code is yours now, so change the styles, props or behavior however you like.

Contact & Community

Have questions or suggestions?

Report bugs, request new component features, or connect with me on X.

Index
0%