NEW
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
shadcn registry is live·
Learn more
Skip to content
Docs

Setup

Make your project animation ready with Animata.

You don't need to install it as a dependency instead you can simply copy and paste the code, as shadcn/ui, into your project. However, you still need to install the other dependency that the code needs.

Requirements

  1. TailwindCSS: We use TailwindCSS for styling. See the TailwindCSS documentation for more information.

  2. Motion (Optionally required): Some complex animations require the motion package. See the Motion documentation for more information.

  3. Lucide Icons or Radix Icon (Optional): Some components use Lucide Icons or Radix Icons. You can use any other icon library or SVG icons as well.

Setting up

Folder structure

The project assumes that you have the following structure:

/
  /components
  /ui

where / is the root of your project, /components is where you keep your components and the project has been set up using paths in the tsconfig.json file.

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./*"]
    }
  }
}

The root of your project can be anything (like src or app), but the components folder should be at the root level.

Install basic dependencies

Install the required dependencies, if you haven't already:

npm install tailwind-merge clsx lucide-react

Create utils.ts file

Create utils.ts file in the libs folder and paste the following code:

import { type ClassValue, clsx } from "clsx";
import { twMerge } from "tailwind-merge";
 
export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}

Copying the code

  1. If you are copying the dependency installation or file creation command make sure to use the copy button as it provides multiple options to copy the code.

Install dependency

  1. If you see something that has been imported but not mentioned in the documentation, then it is a dependency that you need to install. If it starts with @/ then it is Animata's component else it is an external dependency. In such case, you can submit a PR to update the documentation.

  2. If something is not working, then the docs may be missing CSS configuration (custom @keyframes or @theme values). You can look for the relevant CSS entries in Animata's source code. You can create an issue or submit a PR to update the documentation.