# AsheeUI Documentation

> AsheeUI is a modern, accessible React component library engineered with Tailwind CSS. Its config-driven system lets you set component defaults once and override them anywhere, with CSS-variable theming and a CLI for scaffolding.

## Overview & Context

- Full Documentation Text: https://asheeui.com/llms-full.txt
- Official Website: https://asheeui.com
- License: MIT

## Quick Start

- CLI Installation: npx asheeui@latest init
- Core Package: pnpm add asheeui

## Core Guides

- [Getting Started](https://asheeui.com/docs/getting-started): AsheeUI is a config-driven React component library built on Tailwind CSS v4. It gives you a complete set of accessible, styled components with a unified conf...
- [Installation](https://asheeui.com/docs/installation): Setup instructions for Next.js, Vite, and TanStack Start.
- [Theming](https://asheeui.com/docs/theming): AsheeUI's theming system is CSS-variable-driven, giving you full control over colors across your entire application. It ships with two built-in themes (`ligh...
- [Configuration](https://asheeui.com/docs/configuration): The `asheeui.config.ts` file is the central configuration for your AsheeUI project. It's optional (sensible defaults apply with no config at all), but using...
- [CLI Reference](https://asheeui.com/docs/cli): AsheeUI ships a command-line interface for scaffolding, configuring, listing components, and diagnosing or repairing projects.

## Primitives & Components

- [Accordion](https://asheeui.com/docs/components/accordian): A collapsible content panel that organizes information into expandable sections.
- [Autocomplete](https://asheeui.com/docs/components/autocomplete): A searchable dropdown component that allows users to filter and select from a list of options.
- [Button](https://asheeui.com/docs/components/button): A clickable trigger for actions, forms, and navigation.
- [Card](https://asheeui.com/docs/components/card): A versatile container component for displaying content with support for images, headers, footers, and interactive states.
- [Carousel](https://asheeui.com/docs/components/carousel): A slideshow component for cycling through content with auto-play, swipe gestures, and navigation controls.
- [Chip](https://asheeui.com/docs/components/chip): A compact element for displaying labels, tags, categories, or selectable items with support for icons, avatars, and close actions.
- [DatePicker](https://asheeui.com/docs/components/date-picker): A date, time, or datetime selection component with a calendar popover and time spinner.
- [Drawer](https://asheeui.com/docs/components/drawer): A slide-out panel that appears from the edge of the screen for presenting content without navigating away from the current page.
- [Image](https://asheeui.com/docs/components/image): An optimized image component with responsive sizing, aspect ratio control, loading states, and fallback support.
- [Input](https://asheeui.com/docs/components/input): A versatile text input component with support for labels, validation states, icons, and various visual styles.
- [Keyboard](https://asheeui.com/docs/components/keyboard): An on-screen virtual keyboard component designed for touch interfaces and accessibility, with configurable layouts and physical keyboard synchronization.
- [Link](https://asheeui.com/docs/components/link): A navigational element for routing between pages or external resources with support for icons, external indicators, and various visual styles.
- [Marquee](https://asheeui.com/docs/components/marquee): An animated scrolling container that creates a continuous, infinite loop of content with support for both horizontal and vertical directions.
- [Modal](https://asheeui.com/docs/components/modal): A dialog overlay that displays content in a floating container above the page with configurable animations, positions, and sizes.
- [MultiSelect](https://asheeui.com/docs/components/multi-select): A dropdown component that allows users to select multiple options from a list, with support for search, chips, and validation states.
- [PasswordInput](https://asheeui.com/docs/components/password-input): A secure text input with built-in visibility toggle for password fields.
- [Radio](https://asheeui.com/docs/components/radio): A radio input component for selecting a single option from a set, with support for both standalone and group usage.
- [ResizableScreen](https://asheeui.com/docs/components/resizable-screen): A split-pane layout component that allows users to resize two panels by dragging a handle, with keyboard accessibility support.
- [Select](https://asheeui.com/docs/components/select): A dropdown menu for selecting a single option from a list, with support for search, custom styling, and controlled/uncontrolled usage.
- [Sidebar](https://asheeui.com/docs/components/sidebar): A collapsible navigation panel that displays items with support for icons, badges, sections, role-based filtering, and tooltips in collapsed state.
- [Spinner](https://asheeui.com/docs/components/spinner): A lightweight loading indicator that provides visual feedback for asynchronous operations and loading states.
- [Switch](https://asheeui.com/docs/components/switch): A toggle control that allows users to turn a setting on or off, with support for labels, validation states, and loading states.
- [Table](https://asheeui.com/docs/components/table): A flexible data table component for displaying structured data with support for sorting, selection, responsive design, and interactive rows.
- [Tabs](https://asheeui.com/docs/components/tabs): A tabbed interface for organizing content into panels with support for icons, badges, keyboard navigation, and various visual variants.
- [TextArea](https://asheeui.com/docs/components/textarea): A multi-line text input component with support for labels, validation states, resizing, and various visual styles.
- [Toast](https://asheeui.com/docs/components/toast): A notification system for displaying temporary messages with support for different severity levels, custom actions, and configurable positioning.
- [Tooltip](https://asheeui.com/docs/components/tooltip): A floating label that appears on hover or focus to provide additional context about an element.