Getting Started

Installation

Local development keeps the docs app and package builds in the same monorepo loop, while published packages remain independently consumable.

Bootstrap the workspace

Use pnpm at the root so workspace links, Turbo task execution, and Changesets all operate against the same dependency graph.

Install and run · bash

pnpm install
pnpm dev

Consume tokens and components

Applications should import the token stylesheet once near the root, then rely on semantic Tailwind classes or CSS variables in components and layout code.

Root styles · css

@import '@nim-ui/tokens/styles.css';

Component usage · tsx

import { Button } from '@nim-ui/ui';

export function HeroActions() {
  return <Button>Start building</Button>;
}

Monorepo workflows

Use Turbo-powered scripts for consistent build, lint, test, and typecheck behavior. Package boundaries stay explicit, but contributors still get one command surface from the root.

Common scripts · bash

pnpm lint
pnpm test
pnpm build
pnpm typecheck