Installation

@togetheragency/ui is distributed on npm. Add it to your React project with your package manager of choice.

pnpm


pnpm add @togetheragency/ui

npm


npm install @togetheragency/ui

yarn


yarn add @togetheragency/ui

bun


bun add @togetheragency/ui

Peer dependencies

@togetheragency/ui ships components as raw source and relies on your app to provide the runtime. Make sure the following are installed:


pnpm add react react-dom motion tailwindcss

Package	Version	Why
`react`	`^17.0.0` onwards	The component runtime.
`react-dom`	matches `react`	Required for any DOM-rendered React app.
`motion`	`^12`	Used by every animated component in the library.
`tailwindcss`	`^4`	Used for the minimal, overridable default styles.

If you’re using Next.js, Vite, Remix, or any modern React tooling, you almost certainly have react and react-dom already — just add the remaining peers.

Tailwind CSS

Components use Tailwind v4 utility classes for their (minimal, overridable) defaults. If you haven’t set Tailwind up yet, follow the official guide

Importing components

Components are exported per-name. Import them directly from their subpath:


import { Carousel } from "@togetheragency/ui/carousel";
import { Marquee } from "@togetheragency/ui/marquee";
import { Tabs } from "@togetheragency/ui/tabs";

Subpath imports keep your bundle tree-shakeable — you only pay for what you use.

React only components @togetheragency/ui is plug-and-play for React apps only. Many components rely on hooks, refs, and browser APIs, so they ship with the "use client" directive. In a React Server Components setup (Next.js App Router, etc.), import them from a client component or accept that they will run on the client.