Installation

Get started with Things in your project.

Things components are built with shadcn/ui standards. You can install them via our CLI registry or copy the code manually.

Option 1: CLI (Recommended)

The fastest way to install components. This automatically handles dependencies and places files in your `components/ui` folder.

Initialize shadcn (if not already done):

bash
npx shadcn@latest init

Add a component (e.g. Button):

bash
npx shadcn@latest add https://things.marvlock.dev/registry/ui/button.json

Option 2: Manual

1. Install core dependencies

Choose your preferred package manager to install the required styling utilities:

bash
npm install class-variance-authority clsx tailwind-merge lucide-react

2. Add the utils helper

Create lib/utils.ts:

typescript
import { type ClassValue, clsx } from "clsx"
import { twMerge } from "tailwind-merge"

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

3. Copy and Paste

Browse the documentation for any component and copy either the TypeScript or JavaScript code into your project.