Apsara 🧚‍♀️ is an open-source React UI component library built on Base UI primitives. It provides enterprise-grade, accessible components designed for building complex data interfaces.

• Accessible Components: Built on Base UI primitives ensuring ARIA compliance and keyboard navigation
• Flexible Styling: Uses vanilla CSS with HTML data-attributes for powerful theming and style customization
• Enterprise Ready: Designed for complex data-driven applications with components like:
  • Data Tables
  • Navigation Systems
  • Form Controls
  • Feedback Components
• Type Safe: Written in TypeScript with comprehensive type definitions
• Modern Stack: Support for React 18+ and modern development practices

npm install @raystack/apsara
# or
pnpm add @raystack/apsara

// Add Style import in the root of the project.
import "@raystack/apsara/style.css";

// Import components
import { Button, Flex } from "@raystack/apsara";

function App() {
  return (
    <Flex>
      <Button type="primary">I am using 🧚‍♀️ Apsara!</Button>
    </Flex>
  );
}

• Box - Basic layout container
• Flex - Flexbox container
• Container - Responsive wrapper
• Sidebar - Collapsible navigation panel

• Breadcrumb - Navigation breadcrumbs
• Tabs - Tabbed interface
• Command - Command palette interface

• Table - Data table component
• Avatar - User avatar display
• Badge - Status indicators
• EmptyState - Empty state messaging

• Select - Dropdown selection
• Radio - Radio button groups
• IconButton - Icon-only buttons

• Tooltip - Contextual tooltips
• Callout - Informational callouts
• Indicator - Status indicators

• Popover - Contextual overlays
• Drawer - Slide-out panels with swipe-to-dismiss
• Dialog - Modal dialogs

Visit our documentation site for:

• Interactive examples
• API references
• Theme customization
• Accessibility guidelines
• Migration guides

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Run tests
pnpm test

# Build library
pnpm build

Apsara is Apache 2.0 licensed.