Documentation
Aqua Fusion is a comprehensive React component library with built-in design tokens, Tailwind CSS integration, and accessible Radix UI primitives.
What you get
- 30+ atomic components — Button, Input, Card, Badge, Dialog, Toast, and more
- 13 composite patterns — FormField, DataTable, ActionMenu, EmptyState, PageHeader
- Design tokens — Colors, typography, spacing, shadows, animations as Tailwind classes
- Tailwind CSS preset — Drop-in preset with all tokens as CSS custom properties
- Accessible — Built on Radix UI primitives (Checkbox, Popover, DropdownMenu)
- Tree-shakeable — ESM + CJS with code splitting
- TypeScript — Full type definitions included
Quick links
| Section | Description |
|---|---|
| Getting Started | Set up Aqua Fusion in your project in minutes |
| Installation | Detailed installation guide with peer dependencies |
| Usage | Import patterns, component composition, and best practices |
| Theming | Customize colors, typography, and design tokens |
| Components | Browse all 30+ components with examples |
Import paths
| Path | Contents |
|---|---|
@wavebooking/aqua-fusion | All components, patterns, foundations, tokens, hooks |
@wavebooking/aqua-fusion/components | Atomic components only |
@wavebooking/aqua-fusion/patterns | Composite patterns (FormField, DataTable, etc.) |
@wavebooking/aqua-fusion/tokens | Design tokens as Tailwind classes |
@wavebooking/aqua-fusion/foundations | Core design primitives (palette, spacing, etc.) |
@wavebooking/aqua-fusion/hooks | UI hooks (useMediaQuery, useDisclosure, useDebounce) |
@wavebooking/aqua-fusion/preset | Tailwind CSS preset |
@wavebooking/aqua-fusion/styles/theme.css | CSS custom properties for theming |