open-index/open-npm huggingface dataset:
npm package: @jolibox/ui
Description: Preact UI components library based on Ionic React
Latest version: 1.4.16

# @jolibox/ui

A modern UI component library built with Preact and Shoelace.

## Features

- 🚀 Built with Preact for lightweight and fast performance
- 🎨 Based on Shoelace web components for consistent design
- 📦 Tree-shakeable exports
- 🔧 TypeScript support
- 📚 Storybook documentation
- 🎯 Fully customizable components

## Installation

```bash
# Using npm
npm install @jolibox/ui

# Using yarn
yarn add @jolibox/ui

# Using pnpm
pnpm add @jolibox/ui
```

## Usage

```jsx
import { Button } from '@jolibox/ui';

function App() {
  return (
    <Button variant="primary" size="large">
      Click me!
    </Button>
  );
}
```

## Available Components

### Button

A customizable button component with various styles and states.

```jsx
<Button
  variant="primary" // default | primary | success | neutral | warning | danger
  size="medium" // small | medium | large
  disabled={false} // true | false
  loading={false} // true | false
  outline={false} // true | false
  pill={false} // true | false
  circle={false} // true | false
  onClick={() => {}} // click handler
>
  Button Text
</Button>
```

## Development

1. Install dependencies:

```bash
rush update
```

2. Start Storybook:

```bash
cd packages/ui
rush storybook
```

3. Build the library:

```bash
rush build
```

## Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

## License

MIT