PHPackages                             dbiz/spin-wheel-tool - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. dbiz/spin-wheel-tool

ActiveLibrary

dbiz/spin-wheel-tool
====================

A Laravel Nova tool for managing spin wheel activities.

013Vue

Since Nov 19Pushed 1y ago1 watchersCompare

[ Source](https://github.com/haidv1992/spin-wheel-tool)[ Packagist](https://packagist.org/packages/dbiz/spin-wheel-tool)[ RSS](/packages/dbiz-spin-wheel-tool/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Here is the cleaned-up **README.md** without unnecessary local path references:

---

**Spin Wheel Tool for Laravel Nova**
====================================

[](#spin-wheel-tool-for-laravel-nova)

**Spin Wheel Tool** is a Laravel Nova package that allows you to configure a spinning wheel with a flexible frontend interface. The package supports setting prize probabilities from the backend and ensures security by handling the spinning logic on the server. It integrates seamlessly with Laravel Nova, providing an intuitive interface for administrators to manage prizes and configurations.

---

**Features**
------------

[](#features)

- **Backend Configuration**: Easily configure prize probabilities and spin wheel settings via Laravel Nova.
- **Frontend Interface**: Integrate a visually appealing spinning wheel into your frontend using Blade components.
- **Server-Side Logic**: Ensure secure and reliable spin processing on the server.
- **Customizable**: Override specific controller methods to implement custom spin logic or integrate with existing models.
- **Asset Publishing**: Publish and customize frontend assets as needed.

---

**Requirements**
----------------

[](#requirements)

- **Laravel**: Version 8.x or higher
- **Laravel Nova**: Version 4.x or higher
- **Node.js**: Version 14.x or higher
- **PHP**: Version 7.4 or higher

---

**Installation**
----------------

[](#installation)

### **1. Install the Package via Composer**

[](#1-install-the-package-via-composer)

Run the following command to install the package:

```
composer require dbiz/spin-wheel-tool
```

### **2. Publish Configuration and Assets**

[](#2-publish-configuration-and-assets)

Publish the package's configuration file, migrations, and frontend assets using the provided Artisan command:

```
php artisan spinwheeltool:publish
```

Alternatively, publish individual asset types:

```
php artisan vendor:publish --provider="Dbiz\SpinWheelTool\ToolServiceProvider" --tag=config
php artisan vendor:publish --provider="Dbiz\SpinWheelTool\ToolServiceProvider" --tag=migrations
php artisan vendor:publish --provider="Dbiz\SpinWheelTool\ToolServiceProvider" --tag=assets
```

### **3. Run Migrations**

[](#3-run-migrations)

The package requires a `spin_wheel_settings` table to store configuration data. Run the migrations with:

```
php artisan migrate
```

### **4. Install and Compile Frontend Assets**

[](#4-install-and-compile-frontend-assets)

Navigate to the `nova-components/SpinWheelTool` directory and install frontend dependencies:

```
cd nova-components/SpinWheelTool
yarn install
```

#### **Development Build**

[](#development-build)

To compile assets during development and watch for changes:

```
yarn frontend:watch
```

or

```
yarn watch
yarn dev
```

#### **Production Build**

[](#production-build)

To compile assets for production:

```
yarn frontend:build
```

or

```
yarn build
```

---

**Integration**
---------------

[](#integration)

### **1. Register the Tool in NovaServiceProvider**

[](#1-register-the-tool-in-novaserviceprovider)

To register the tool in Laravel Nova, open your `NovaServiceProvider` file and add the `SpinWheelTool` to the `tools()` method:

```
public function tools()
{
    return [
        new \Dbiz\SpinWheelTool\SpinWheelTool(),
    ];
}
```

### **2. Add Menu Section for Backend Navigation**

[](#2-add-menu-section-for-backend-navigation)

Add a menu section for the Spin Wheel Tool in your Nova menu configuration:

```
use Laravel\Nova\Menu\MenuSection;
use Laravel\Nova\Menu\MenuItem;

public function menu()
{
    return [
        MenuSection::make('Quay thưởng', [
            MenuItem::make('Cấu hình', '/nova-vendor/spin-wheel-tool/setting'),
        ])->icon('refresh')->collapsable(),
    ];
}
```

This will add a collapsible "Quay thưởng" section in the Nova backend, allowing administrators to access the Spin Wheel Tool's configuration page.

---

**Usage**
---------

[](#usage)

### **1. Configure Prize Probabilities in the Backend**

[](#1-configure-prize-probabilities-in-the-backend)

In Laravel Nova, navigate to the **Spin Wheel Tool** menu. Here, you can configure prize probabilities and spin wheel settings.

#### **Configure Prizes**

[](#configure-prizes)

Define your prizes with the following attributes:

- **`id`**: Unique identifier for the prize.
- **`name`**: Name of the prize.
- **`weight`**: Probability weight of the prize. The chance of winning is calculated based on the total weight.
- **`display_option`**: Determines how the prize is displayed (`icon`, `text`, or `both`).
- **`backgroundColor`**: Background color for the prize segment.

Example JSON configuration:

```
[
  {
    "id": 1,
    "name": "Prize 1",
    "weight": 10,
    "display_option": "both",
    "backgroundColor": "#FFC20E"
  },
  {
    "id": 2,
    "name": "Prize 2",
    "weight": 20,
    "display_option": "icon",
    "backgroundColor": "#4AC6FF"
  },
  {
    "id": 3,
    "name": "Prize 3",
    "weight": 30,
    "display_option": "text",
    "backgroundColor": "#DE2B2E"
  }
]
```

#### **Configure Spin Wheel Settings**

[](#configure-spin-wheel-settings)

Adjust spin wheel behavior such as spin duration, number of revolutions, easing function, and rotation resistance.

Default configuration:

```
{
  "spinDuration": 4000,
  "numberOfRevolutions": 20,
  "easingFunction": "cubicOut",
  "rotationResistance": -35
}
```

#### **Set Spin Limit**

[](#set-spin-limit)

Define the maximum number of spins allowed per user per day in the `config/spinwheeltool.php` file:

```
'spin_limit' => 3, // Set your desired spin limit
```

### **2. Integrate the Spinning Wheel into the Frontend**

[](#2-integrate-the-spinning-wheel-into-the-frontend)

#### **Blade Component**

[](#blade-component)

Embed the spinning wheel interface into any Blade page using the following Blade component:

```

```

This component will render the spinning wheel interface, allowing users to perform spins.

#### **Direct Route Access**

[](#direct-route-access)

Alternatively, access the spinning interface directly via the provided route:

```
/nova-vendor/spin-wheel-tool/frontend

```

---

**Development**
---------------

[](#development)

### **1. Modify the Interface or Spinning Logic**

[](#1-modify-the-interface-or-spinning-logic)

- **Frontend Interface**: All Vue.js components are located in the `nova-components/SpinWheelTool/resources/js/components` directory. You can edit files like `SpinWheel.vue` or other related components to customize the spinning wheel's appearance and behavior.
- **CSS**: Modify styles in `nova-components/SpinWheelTool/resources/css/tool.css` to adjust the spinning wheel's design.

---

**Final Notes**
---------------

[](#final-notes)

By following this comprehensive guide, you can effectively install, configure, and customize the Spin Wheel Tool package within your Laravel Nova project. For any further assistance or inquiries, please refer to the [GitHub repository](https://github.com/yourusername/spin-wheel-tool) or contact the maintainer directly.

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity16

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/995420a65df204496f8c698f8fb5395995cd257cf6283034858a3e29b63b467d?d=identicon)[haidv1992](/maintainers/haidv1992)

### Embed Badge

![Health badge](/badges/dbiz-spin-wheel-tool/health.svg)

```
[![Health](https://phpackages.com/badges/dbiz-spin-wheel-tool/health.svg)](https://phpackages.com/packages/dbiz-spin-wheel-tool)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)