API Reference

Shared conventions across attn/ui components.

API Reference

attn/ui components are intentionally small, but they follow a few shared rules.

Design principles

  • Prefer obvious defaults over broad configuration
  • Expose composition points instead of large prop surfaces
  • Keep animation meaningful, not decorative
  • Treat accessibility as part of the API, not an add-on

Styling model

Components are authored with Tailwind utilities and class variance where useful.

  • className is exposed when external styling is appropriate
  • Visual tokens follow semantic names like background, foreground, and muted
  • Motion should respect reduced-motion preferences when interaction depends on animation

Distribution model

Registry items are published as code, not runtime packages.

pnpm dlx shadcn@latest add https://attnui.com/r/<component>.json

Component categories

  • button
  • avatar
  • tooltip
  • nested-drawer
  • animated-avatar-stack
  • timezone-clock