# Shadix

![Hex.pm Version](https://img.shields.io/hexpm/v/shadix)
![Hex.pm License](https://img.shields.io/hexpm/l/shadix)

A set of beautiful and customizable components for Phoenix LiveView. It's shadcn/ui but for Phoenix: start here, then make it your own. See examples on our [docs site](https://shadix.workinghypothes.is/).

When you install a component from shadix, it gets copied into your own codebase where
you can freely edit it -- styled with Tailwind v4.

> [!WARNING]
> This project is still in early development and does not have a stable API.

## Usage

```sh
# One-time setup
mix shadix.init

# Copy a component (and its dependencies) into your app
# (module defaults to <YourApp>Web.Components.UI):
mix shadix.add button
mix shadix.add card dialog        # multiple at once
mix shadix.add button --namespace MyAppWeb.UI --dir lib/my_app_web/ui
```

Files are copied into your project — you own and edit them. Re-running won't
overwrite your edits unless you pass `--force`.