Installation

Weaveworm works in any React app using Tailwind v4. Components are installed copy-paste via the shadcn CLI, so you own every line.

  1. 1

    Register the registry

    The weaveworm CLI adds the @weaveworm namespace to your components.json.

    npx weaveworm init
  2. 2

    Add the Tailwind preset

    Import the preset once in your global stylesheet:

    @import "@weaveworm/tailwind/theme.css";

    This pulls in Tailwind, the Weaveworm design tokens (as CSS variables), and maps them onto Tailwind's theme.

  3. 3

    Add components

    Install any component by name — dependencies come with it:

    npx shadcn@latest add @weaveworm/button
npx shadcn@latest add @weaveworm/conversation
  4. 4

    Use it

    import { Button } from "@/components/ui/button";

export function Example() {
  return <Button>Hello, Weaveworm</Button>;
}