• ✅ Battle-tested in production at GAIA
• ✅ Designed to handle edge cases and real-world scenarios
• ✅ Accessible, responsive, and performant
• ✅ Solving problems better than existing alternatives

You won't find generic components that duplicate what's already available. If we're shipping it, it's because we use it in production and it adds genuine value to the ecosystem.

Getting Started

Add components to your project:

npx @heygaia/ui add navbar-menu

Add multiple components at once:

npx @heygaia/ui add raised-button chat-bubble tool-calls-section

Alternative: Using shadcn CLI

You can also use the shadcn CLI directly with the full registry URL:

npx shadcn@latest add https://ui.heygaia.io/r/navbar-menu.json

Or configure the @heygaia namespace in your components.json:

{
  "registries": {
    "@heygaia": "https://ui.heygaia.io/r/{name}.json"
  }
}

Then use namespace syntax:

npx shadcn@latest add @heygaia/navbar-menu

Base Components

This registry uses standard shadcn/ui base components. Install them separately:

npx shadcn@latest add button tooltip avatar dropdown-menu popover skeleton

Documentation

• Component Docs - Live examples and API reference
• Contributing Guide - Complete guide for adding components
• Roadmap - See what's coming next

Current Status

GAIA UI is in beta. We're actively migrating components from our internal GAIA codebase, replacing HeroUI with shadcn/ui for better compatibility and smaller bundle sizes. The library is stable and used in production, but APIs may change as we refine components before v1.0.

View detailed roadmap →

Community & Support

Join our growing community of users and contributors:

•  Discord — Chat with the team and other users.
•  Twitter — Get the latest news and updates.
•  GitHub — Report issues and contribute.

Contributing

We welcome contributions! Whether you're fixing bugs, improving documentation, or adding new components, we'd love your help.

Read the Contributing Guide →

Quick start for contributors:

1. Fork the repository
2. Create your component in registry/new-york/ui/
3. Add entry to registry.json and run pnpm run registry:build
4. Test locally with npx shadcn@latest add http://localhost:3000/r/[component-name].json
5. Submit a pull request

Development

# Install dependencies
pnpm install

# Run dev server
pnpm run dev

# Build registry
pnpm run registry:build

# Type check
pnpm run type

Built With

• Next.js 15 - For the documentation and registry
• Tailwind CSS v4 - For styling
• TypeScript - For type safety
• Radix UI - For accessible primitives
• Framer Motion - For animations
• shadcn CLI - For component installation

Star History

License

MIT License - feel free to use these components in your projects!

Made with ❤️ by