# tao-ui > React 18.2 and 19 components with machine-readable metadata, semantic DOM contracts, and predictable theming. ## Guide - [Getting Started](https://rickyshin93.github.io/tao-ui/guide/getting-started.md): Install tao-ui with React 18.2 or React 19, add TaoProvider, and render your first accessible component with inherited theme settings. - [Working with AI agents](https://rickyshin93.github.io/tao-ui/guide/agents.md): Find tao-ui component imports, semantic DOM contracts, complete API tables and runnable examples through JSON, Markdown and browser tools. - [Changelog](https://rickyshin93.github.io/tao-ui/guide/changelog.md): Version history for @rockshin/tao-ui, including fixes for uploads, selection, forms and overlays. ## Components - [BorderBeam](https://rickyshin93.github.io/tao-ui/components/border-beam.md): Highlights an active surface with a moving border light. - [Button](https://rickyshin93.github.io/tao-ui/components/button.md): Trigger actions with accessible Button variants, sizes, loading states, and semantic class or style customization. - [Icons](https://rickyshin93.github.io/tao-ui/components/icons.md): Browse tao-icons, search by name or category, and copy React imports. - [FloatButton](https://rickyshin93.github.io/tao-ui/components/float-button.md): Provides persistent floating actions and a return-to-top control. - [Watermark](https://rickyshin93.github.io/tao-ui/components/watermark.md): Repeats text or an image across content and inherited dialogs. - [Divider](https://rickyshin93.github.io/tao-ui/components/divider.md): Separates content into readable sections or inline groups. - [FormLayout](https://rickyshin93.github.io/tao-ui/components/form-layout.md): Arranges form content with consistent label and control alignment. Includes usage guidance, a runnable example, and the complete API reference. - [Splitter](https://rickyshin93.github.io/tao-ui/components/splitter.md): Creates resizable panes separated by draggable handles. Includes usage guidance, a runnable example, and the complete API reference. - [Stack](https://rickyshin93.github.io/tao-ui/components/stack.md): Composes children in a flex row or column with consistent spacing. Includes usage guidance, a runnable example, and the complete API reference. - [Affix](https://rickyshin93.github.io/tao-ui/components/affix.md): Pins content when it crosses a scroll container boundary. - [Breadcrumb](https://rickyshin93.github.io/tao-ui/components/breadcrumb.md): Renders the user location in a hierarchy of pages or views. Includes usage guidance, a runnable example, and the complete API reference. - [ContextMenu](https://rickyshin93.github.io/tao-ui/components/context-menu.md): Displays contextual actions from a right click or long press interaction. Includes usage guidance, a runnable example, and the complete API reference. - [Dropdown](https://rickyshin93.github.io/tao-ui/components/dropdown.md): Opens a menu of actions or navigation choices from a trigger. Includes usage guidance, a runnable example, and the complete API reference. - [Pagination](https://rickyshin93.github.io/tao-ui/components/pagination.md): Moves through paged data with current page and page-size controls. Includes usage guidance, a runnable example, and the complete API reference. - [Steps](https://rickyshin93.github.io/tao-ui/components/steps.md): Guides users through the ordered stages of a task. Includes usage guidance, runnable examples for every type and variant, and the complete API reference. - [Tabs](https://rickyshin93.github.io/tao-ui/components/tabs.md): Switches between peer panels within the same page context. Includes usage guidance, a runnable example, and the complete API reference. - [AutoComplete](https://rickyshin93.github.io/tao-ui/components/auto-complete.md): Editable text with suggestions, grouped options, keyboard completion and custom inputs. - [Cascader](https://rickyshin93.github.io/tao-ui/components/cascader.md): Choose paths through hierarchical options with search, a standalone panel and a mobile drawer with confirmation for multiple selections. - [Checkbox](https://rickyshin93.github.io/tao-ui/components/checkbox.md): Selects one or more independent boolean options. Includes usage guidance, a runnable example, and the complete API reference. - [ColorPicker](https://rickyshin93.github.io/tao-ui/components/color-picker.md): Choose solid or gradient colors with precise Color objects, presets and format conversion. - [DatePicker](https://rickyshin93.github.io/tao-ui/components/date-picker.md): Lets users enter or choose a single date, with optional time selection. Includes usage guidance, a runnable example, and the complete API reference. - [Form](https://rickyshin93.github.io/tao-ui/components/form.md): Collects and validates field values with an antd-aligned API for rules, dependencies, and Form.List, backed by the rc-form engine. - [FormActions](https://rickyshin93.github.io/tao-ui/components/form-actions.md): Lays out submit, cancel, and secondary actions for forms. Includes usage guidance, a runnable example, and the complete API reference. - [FormField](https://rickyshin93.github.io/tao-ui/components/form-field.md): Associates labels, help text, validation state, and controls. Includes usage guidance, a runnable example, and the complete API reference. - [FormSection](https://rickyshin93.github.io/tao-ui/components/form-section.md): Groups related form fields with a title and optional description. Includes usage guidance, a runnable example, and the complete API reference. - [Input](https://rickyshin93.github.io/tao-ui/components/input.md): Input family with clearing, counting, password visibility, search, text areas and one-time codes. Includes runnable examples, keyboard behavior and API reference. - [InputNumber](https://rickyshin93.github.io/tao-ui/components/input-number.md): A styled numeric input built on tao-ui number formatting and validation behavior. Includes usage guidance, a runnable example, and the complete API reference. - [Mentions](https://rickyshin93.github.io/tao-ui/components/mentions.md): Text areas with prefix-triggered suggestions, keyboard insertion, async options and automatic sizing. - [Radio](https://rickyshin93.github.io/tao-ui/components/radio.md): Selects exactly one option from a mutually exclusive set. Includes usage guidance, a runnable example, and the complete API reference. - [RangePicker](https://rickyshin93.github.io/tao-ui/components/range-picker.md): Choose start and end dates with optional time and presets. Learn how to control, clear and localize the range. - [Rate](https://rickyshin93.github.io/tao-ui/components/rate.md): Lets people choose a rating with full or half steps. - [Segmented](https://rickyshin93.github.io/tao-ui/components/segmented.md): Selects one view or mode from a compact set of choices. - [Select](https://rickyshin93.github.io/tao-ui/components/select.md): Runnable examples for wrapping long option labels, single and multiple selection, tags, token separators, filtering, groups, dependent choices, async loading, rendering, popup controls, mobile drawers, and forms. - [Slider](https://rickyshin93.github.io/tao-ui/components/slider.md): Selects a numeric value or range using pointer and keyboard input. - [Switch](https://rickyshin93.github.io/tao-ui/components/switch.md): Toggles a setting on or off with immediate effect. Includes usage guidance, a runnable example, and the complete API reference. - [Textarea](https://rickyshin93.github.io/tao-ui/components/textarea.md): Multi-line input with auto sizing, clearing, custom counts and Enter events, also available as Input.TextArea. - [TimePicker](https://rickyshin93.github.io/tao-ui/components/time-picker.md): Select a time or time range with steps, disabled intervals, formatting and confirmation. - [Transfer](https://rickyshin93.github.io/tao-ui/components/transfer.md): Moves records between available and selected collections. - [TreeSelect](https://rickyshin93.github.io/tao-ui/components/tree-select.md): Select values from hierarchical options with search, multiple selection and linked checkboxes. - [Upload](https://rickyshin93.github.io/tao-ui/components/upload.md): Select and manage files, connect an upload endpoint, and handle progress, errors and cancellation in a controlled list. - [Avatar](https://rickyshin93.github.io/tao-ui/components/avatar.md): Identifies people or entities using images, initials or icons. - [Badge](https://rickyshin93.github.io/tao-ui/components/badge.md): Shows counts, compact status indicators and ribbons. - [Calendar](https://rickyshin93.github.io/tao-ui/components/calendar.md): Display months or years with event cells, custom headers and selectable ranges. - [Card](https://rickyshin93.github.io/tao-ui/components/card.md): Groups related content, actions and tabbed views in a surface. - [Carousel](https://rickyshin93.github.io/tao-ui/components/carousel.md): Slides with native arrows and dots, automatic playback, fade transitions, responsive layouts and ref controls. - [Collapse](https://rickyshin93.github.io/tao-ui/components/collapse.md): Item-based panels with built-in headers, expand icons and content regions; supports independent panels and accordions. - [Descriptions](https://rickyshin93.github.io/tao-ui/components/descriptions.md): Displays labelled fields in a structured record view. - [Empty](https://rickyshin93.github.io/tao-ui/components/empty.md): Explains why a collection has no content and provides a useful next action. - [Image](https://rickyshin93.github.io/tao-ui/components/image.md): Images with full-screen preview, grouped navigation, zoom and rotation, fallbacks and progress placeholders. - [List](https://rickyshin93.github.io/tao-ui/components/list.md): Displays repeated records with metadata, actions, pagination or a responsive grid. - [Listy](https://rickyshin93.github.io/tao-ui/components/listy.md): Renders scrollable item collections with grouping and optional virtualization. - [Masonry](https://rickyshin93.github.io/tao-ui/components/masonry.md): Arranges cards of different heights into balanced columns. - [Popover](https://rickyshin93.github.io/tao-ui/components/popover.md): Displays a floating card with rich content anchored to a trigger element, opened by click or hover. Usage guidance, runnable example, and API reference. - [QRCode](https://rickyshin93.github.io/tao-ui/components/qr-code.md): Generate scannable Canvas or SVG QR codes with icons, status and refresh controls. - [ScrollArea](https://rickyshin93.github.io/tao-ui/components/scroll-area.md): Provides a styled scroll container for overflow content. Includes usage guidance, a runnable example, and the complete API reference. - [Statistic](https://rickyshin93.github.io/tao-ui/components/statistic.md): Highlights numeric values, formatted metrics and elapsed time. - [Table](https://rickyshin93.github.io/tao-ui/components/table.md): Display structured data with sorting, filtering, pagination and controlled row selection. - [Tag](https://rickyshin93.github.io/tao-ui/components/tag.md): Displays compact labels, statuses, categories, or checkable chips. Includes usage guidance, a runnable example, and the complete API reference. - [Timeline](https://rickyshin93.github.io/tao-ui/components/timeline.md): Orders events and milestones along a vertical or horizontal rail. - [Tooltip](https://rickyshin93.github.io/tao-ui/components/tooltip.md): Shows a brief informational popup when hovering or focusing an element. Includes usage guidance, a runnable example, and the complete API reference. - [Tree](https://rickyshin93.github.io/tao-ui/components/tree.md): Hierarchical data with selection, checkboxes, async children, dragging and virtual scrolling. - [Alert](https://rickyshin93.github.io/tao-ui/components/alert.md): Displays important contextual feedback messages with semantic status types. Includes usage guidance, a runnable example, and the complete API reference. - [Drawer](https://rickyshin93.github.io/tao-ui/components/drawer.md): Opens a side panel for related tasks without leaving the current page. Includes usage guidance, a runnable example, and the complete API reference. - [Modal](https://rickyshin93.github.io/tao-ui/components/modal.md): Displays a focused dialog for decisions, forms, and interruptive information. Includes usage guidance, a runnable example, and the complete API reference. - [Popconfirm](https://rickyshin93.github.io/tao-ui/components/popconfirm.md): Shows a compact confirmation popup anchored to a trigger element, with OK and Cancel actions. Usage guidance, runnable example, and API reference. - [Progress](https://rickyshin93.github.io/tao-ui/components/progress.md): Displays measurable completion with lines, circles or dashboard arcs. - [Result](https://rickyshin93.github.io/tao-ui/components/result.md): Shows the outcome of a completed operation, including recovery actions. - [Skeleton](https://rickyshin93.github.io/tao-ui/components/skeleton.md): Preserves content structure while data is loading. - [Sonner](https://rickyshin93.github.io/tao-ui/components/sonner.md): Displays temporary toast notifications with optional actions and provider-aware theming. Usage guidance, runnable example, and API reference. - [Spinner](https://rickyshin93.github.io/tao-ui/components/spinner.md): Indicates indeterminate loading activity. Includes usage guidance, a runnable example, and the complete API reference. - [Tour](https://rickyshin93.github.io/tao-ui/components/tour.md): Guided steps with target positioning, spotlight masks, custom actions and keyboard navigation. - [HeadlessInputNumber](https://rickyshin93.github.io/tao-ui/components/headless-input-number.md): Headless numeric input primitives and hook for custom number entry experiences. Includes usage guidance, a runnable example, and the complete API reference. - [App](https://rickyshin93.github.io/tao-ui/components/app.md): Provides scoped message, notification and modal instances with application context. - [TaoProvider](https://rickyshin93.github.io/tao-ui/components/tao-provider.md): Provides global defaults, portal scoping, and theme seed token overrides, with usage guidance, runnable examples, and a complete API reference. - [Util](https://rickyshin93.github.io/tao-ui/components/util.md): Infer TypeScript types from components and their public props without a runtime helper. ## Showcase - [Operations console showcase](https://rickyshin93.github.io/tao-ui/showcase/commerce.md): Explore an interactive operations console built with tao-ui and tao-icons. - [Showcase](https://rickyshin93.github.io/tao-ui/showcase.md): Explore interactive product examples built with tao-ui and tao-icons. ## Package contracts - [Agent discovery index](https://rickyshin93.github.io/tao-ui/agent-manifest.json): @rockshin/tao-ui 0.0.57, imports and bilingual documentation URLs. - [Component metadata](https://rickyshin93.github.io/tao-ui/component-manifest.json): semantic parts, usage guidance and selected props.