@arolariu/components/src/stories/Welcome.mdx

🎨 70+ beautiful, accessible React components built on Base UI. TypeScript-first, CSS Modules styling, tree-shakeable, SSR-ready. Perfect for modern web apps, design systems & rapid prototyping. Zero config, maximum flexibility! ⚡

{/* @meta title: Introduction/Welcome */}

# 👋 Welcome to @arolariu/components

A modern, accessible React component library built on **Base UI** primitives with **CSS Modules** and **OKLCH** design tokens.

## ✨ Highlights

- **84+ components** — From buttons to data tables, charts to animated backgrounds
- **23 hooks** — Utility hooks for state, media queries, clipboard, local storage
- **Base UI foundation** — Accessible, composable, lightweight
- **CSS Modules** — Scoped styles, zero Tailwind dependency
- **OKLCH color space** — Perceptually uniform, modern color tokens
- **95%+ test coverage** — 1300+ tests across all components
- **TypeScript strict** — Full type safety, no `any` types
- **Dark mode** — Built-in light/dark theme support via CSS variables
- **Motion system** — Animation tokens, presets, and utilities

## 🚀 Quick Start

```bash
npm install @arolariu/components @base-ui/react motion
```

```tsx
import "@arolariu/components/styles";
import {Button} from "@arolariu/components";

function App() {
  return <Button variant="default">Click me</Button>;
}
```

## 📚 Explore

- **[Design Tokens](?path=/docs/foundations-design-tokens--docs)** — Colors, spacing, typography, radius
- **[Components](?path=/docs/components-actions-button--docs)** — Interactive UI building blocks
- **[Hooks](?path=/docs/components-actions-button--docs)** — Utility hooks for common patterns

## 🔗 Links

- [GitHub Repository](https://github.com/arolariu/arolariu.ro)
- [npm Package](https://www.npmjs.com/package/@arolariu/components)
- [arolariu.ro](https://arolariu.ro)