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.
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.
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.
Add components to your project:
npx @heygaia/ui add navbar-menuAdd multiple components at once:
npx @heygaia/ui add raised-button chat-bubble tool-calls-sectionYou can also use the shadcn CLI directly with the full registry URL:
npx shadcn@latest add https://ui.heygaia.io/r/navbar-menu.jsonOr 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-menuThis registry uses standard shadcn/ui base components. Install them separately:
npx shadcn@latest add button tooltip avatar dropdown-menu popover skeleton- Component Docs - Live examples and API reference
- Contributing Guide - Complete guide for adding components
- Roadmap - See what's coming next
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.
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.
We welcome contributions! Whether you're fixing bugs, improving documentation, or adding new components, we'd love your help.
Quick start for contributors:
- Fork the repository
- Create your component in
registry/new-york/ui/ - Add entry to
registry.jsonand runpnpm run registry:build - Test locally with
npx shadcn@latest add http://localhost:3000/r/[component-name].json - Submit a pull request
# Install dependencies
pnpm install
# Run dev server
pnpm run dev
# Build registry
pnpm run registry:build
# Type check
pnpm run type- 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
MIT License - feel free to use these components in your projects!
Made with ❤️ by
