# BetSwirl UI - React Casino Game Components

This is a **game widget library** for BetSwirl protocol casino games built with React + TypeScript + Vite.

## Available Games

* 🪙 **CoinToss** - Classic heads/tails game with animated coin flip
* 🎲 **Dice** - Roll the dice with customizable win conditions
* 🎰 **Roulette** - European roulette with single zero
* 🎱 **Keno** - Pick your lucky numbers and win big
* 🎡 **Wheel** - Spin the wheel of fortune

## Quick Start

🚀 **Build a Web3 casino dApp with just few lines of React code!**

* 📖 [Create your React dApp](https://docs.betswirl.com/developer-hub/demos/ui-react/react) - Step-by-step tutorial
* 🎮 [Live Demo](https://ui-react-demo.betswirl.com/) - See it in action ([source code](https://github.com/BetSwirl/ui-react-demo))
* 🎨 [Storybook](https://ui-react-storybook.betswirl.com) - Explore all components interactively

🪐 **Create a casino Farcaster Mini App with BetSwirl games**

* 📖 [Create your Mini App](https://docs.betswirl.com/developer-hub/demos/ui-react/miniapp)
* 🎮 [Live Demo](https://farcaster.xyz/miniapps/M926rOlymYrS/betswirl-mini-app-demo) - See it in action ([source code](https://github.com/BetSwirl/miniapp-ui-react-demo))

## Installation

```shell
npm i @betswirl/ui-react
```

## Features

- 🎯 **5 Casino Games** - CoinToss, Dice, Roulette, Keno, Wheel
- ⚡ **Fast Integration** - Get started in minutes
- 🎨 **Customizable** - Built with Tailwind CSS
- 🔗 **Web3 Ready** - Works with any wallet provider
- 📱 **Mobile Friendly** - Responsive design
- 🧪 **TypeScript** - Full type safety

## Development

For contributors and maintainers, see [DEVELOPMENT.md](./DEVELOPMENT.md)