# AtroUI

> Dark-first React / Next.js catalog on the official shadcn registry. MIT. You own the copied files.
> Install: npx shadcn@latest add @atroui/home-hero  (any @atroui/… item)
> Public namespace @atroui — listed in https://ui.shadcn.com/r/registries.json — no GitHub token, not a private GitHub registry.
> Tailwind CSS v4 (not v3 @apply / opacity syntax).
> Optional Host APIs (npm i atroui + transpilePackages): contact, waitlist, newsletter, OG, thumbnail, scope. BYOK: SMTP/Resend, Hugging Face/Gemini/xAI. AtroUI never holds keys and does not run paid AI on atroui.com. Missing keys → 503 on the consumer app.
> Host APIs: https://www.atroui.com/docs/host-api
> Compare (not Magic UI / Aceternity): https://www.atroui.com/docs/compare
> Site: https://www.atroui.com
> Registry JSON: https://www.atroui.com/r/{name}.json
> Repo: https://github.com/atroui/atroui
> npm (package atroui): https://www.npmjs.com/package/atroui

## Install

```bash
npx shadcn@latest init
npx shadcn@latest add @atroui/home-hero
```

`@atroui` is in the official shadcn registry directory. No manual `registry add` URL step.

## Key pages

- Home: https://www.atroui.com
- Docs: https://www.atroui.com/docs
- Installation: https://www.atroui.com/docs/installation
- Registry: https://www.atroui.com/docs/registry
- Theming: https://www.atroui.com/docs/theming
- Brand kit: https://www.atroui.com/docs/brand
- Compare: https://www.atroui.com/docs/compare
- Collections: https://www.atroui.com/docs/collections
- Glossary: https://www.atroui.com/docs/glossary
- Full catalog (plain text): https://www.atroui.com/llms-full.txt
- Blog: https://www.atroui.com/blog
- Changelog: https://www.atroui.com/docs/changelog
- Components: https://www.atroui.com/docs/components
- Catalog JSON: https://www.atroui.com/r/registry.json

## Registry highlights

### Primitives
- @atroui/button, @atroui/card, @atroui/textarea, @atroui/form-select
- @atroui/breadcrumbs, @atroui/prose, @atroui/theme-toggle, @atroui/theme-provider, @atroui/logo
- @atroui/mockup-frame, @atroui/timeline-animation, @atroui/founder-avatar
- @atroui/fade-in, @atroui/stagger, @atroui/scroll-progress

### Blocks
- @atroui/home-hero, @atroui/site-header, @atroui/site-footer, @atroui/faq
- @atroui/pricing-overview, @atroui/contact-form, @atroui/waitlist-form
- @atroui/social-share, @atroui/before-after-slider, @atroui/visual-case-study
- @atroui/ar-portfolio, @atroui/live-dashboard, @atroui/project-planner
- @atroui/json-ld, @atroui/testimonial-schema, @atroui/analytics-provider
- @atroui/og-live-preview, @atroui/og-workspace, @atroui/thumbnail-workspace, @atroui/scope-chat

Full catalog: https://www.atroui.com/r/registry.json

## Blog

- https://www.atroui.com/blog

## Related

- GitHub: https://github.com/atroui/atroui
- npm (tokens / package): https://www.npmjs.com/package/atroui
- shadcn directory: https://ui.shadcn.com/docs/directory?q=atroui