GAIA UI - Component Registry
A collection of production-ready UI components designed specifically for building AI assistants and chatbots. These are the components we use at GAIA, now available for anyone building conversational interfaces.
Why This Library?
Building a great chat or assistant interface requires more than just generic UI components. We've spent countless hours refining these components to handle the unique challenges of conversational UIs.
Instead of reinventing the wheel, use the same battle-tested components that power GAIA.
Our Philosophy
Quality Over Quantity - We focus on shipping production-ready components that solve real problems. Each component is:
- ✅ 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:
- Fork the repository
- Create your component in
registry/new-york/ui/
- Add entry to
registry.json and run pnpm run registry:build
- Test locally with
npx shadcn@latest add http://localhost:3000/r/[component-name].json
- 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
