Repository files navigation

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

• Accessible Components: Built on Radix 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# orpnpm add @raystack/apsara

// Add Style import in the root of the project.import"@raystack/apsara/style.css";// Import componentsimport{Button,Flex}from"@raystack/apsara/v1";functionApp(){return(<Flex><Buttontype="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
• Sheet - Slide-out panels
• Dialog - Modal dialogs

Visit ourdocumentation 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 dependenciespnpm install# Start development serverpnpm dev# Run testspnpmtest# Build librarypnpm build

Apsara isApache 2.0 licensed.