PHPackages                             codehero-mx/nova-permission-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. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. codehero-mx/nova-permission-tool

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

codehero-mx/nova-permission-tool
================================

A Laravel Nova tool for Spatie's Permission library.

v4.0(3y ago)0638MITPHPPHP ^7.4|^8.0|^8.1

Since Mar 2Pushed 3y agoCompare

[ Source](https://github.com/codehero-mx/nova-permission-tool)[ Packagist](https://packagist.org/packages/codehero-mx/nova-permission-tool)[ RSS](/packages/codehero-mx-nova-permission-tool/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

A Laravel Nova tool for Spatie's laravel-permission library
===========================================================

[](#a-laravel-nova-tool-for-spaties-laravel-permission-library)

[![Latest Version on Packagist](https://camo.githubusercontent.com/445a90513a217a5455b90172511637e4aa4790f2317b7ca6784b2bb45a167e8d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f64656865726f2d6d782f6e6f76612d7065726d697373696f6e2d746f6f6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codehero-mx/nova-permission-tool)[![Total Downloads](https://camo.githubusercontent.com/9bec593f0d6bc9e9bd0eea8f62f18a1d3244b4c91d007534503aedc864fdb479/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f64656865726f2d6d782f6e6f76612d7065726d697373696f6e2d746f6f6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codehero-mx/nova-permission-tool)

[![screenshot 1](https://raw.githubusercontent.com/codehero-mx/nova-permission-tool/main/docs/user-resource.png)](https://raw.githubusercontent.com/codehero-mx/nova-permission-tool/main/docs/user-resource.png)

Installation
------------

[](#installation)

You can install the package in to a Laravel app that uses [Nova](https://nova.laravel.com) via composer:

```
composer require codehero-mx/nova-permission-tool
```

Go through the [Installation](https://github.com/spatie/laravel-permission#installation) section in order to setup [laravel-permission](https://packagist.org/packages/spatie/laravel-permission).

Next up, you must register the tool with Nova. This is typically done in the `tools` method of the `NovaServiceProvider`.

```
// in app/Providers/NovaServiceProvider.php

// ...

public function tools()
{
    return [
        // ...
        \CodeHeroMX\NovaPermission\NovaPermissionTool::make(),
    ];
}
```

Next, add middleware to `config/nova.php`

```
// in config/nova.php
'middleware' => [
    // ...
    \CodeHeroMX\NovaPermission\ForgetCachedPermissions::class,
],
```

Finally, add `MorphToMany` fields to you `app/Nova/User` resource:

```
// ...
use Laravel\Nova\Fields\MorphToMany;

public function fields(Request $request)
{
    return [
        // ...
        MorphToMany::make('Roles', 'roles', \CodeHeroMX\NovaPermission\Role::class),
        MorphToMany::make('Permissions', 'permissions', \CodeHeroMX\NovaPermission\Permission::class),
    ];
}
```

Or if you want to attach multiple permissions at once, use `RoleBooleanGroup` and `PermissionBooleanGroup` fields (requires at least Nova 2.6.0):

```
// ...
use CodeHeroMX\NovaPermission\PermissionBooleanGroup;
use CodeHeroMX\NovaPermission\RoleBooleanGroup;

public function fields(Request $request)
{
    return [
        // ...
        RoleBooleanGroup::make('Roles'),
        PermissionBooleanGroup::make('Permissions'),
    ];
}
```

If your `User` could have a single role at any given time, you can use `RoleSelect` field. This field will render a standard select where you can pick a single role from.

```
// ...
use CodeHeroMX\NovaPermission\PermissionBooleanGroup;
use CodeHeroMX\NovaPermission\RoleSelect;

public function fields(Request $request)
{
    return [
        // ...
        RoleSelect::make('Role', 'roles'),
    ];
}
```

Configuration
-------------

[](#configuration)

You can optionally publish the config file with:

```
php artisan vendor:publish --provider="CodeHeroMX\NovaPermission\ToolServiceProvider" --tag="config"
```

Customization
-------------

[](#customization)

If you want to use custom resource classes you can define them when you register a tool:

```
// in app/Providers/NovaServiceProvider.php

// ...

public function tools()
{
    return [
        // ...
        \CodeHeroMX\NovaPermission\NovaPermissionTool::make()
            ->roleResource(CustomRole::class)
            ->permissionResource(CustomPermission::class),
    ];
}
```

If you want to show your roles and policies with a custom label, you can set `$labelAttribute` when instantiating your fields:

```
// ...
use CodeHeroMX\NovaPermission\PermissionBooleanGroup;
use CodeHeroMX\NovaPermission\RoleSelect;

public function fields(Request $request)
{
    return [
        // ...
        RoleBooleanGroup::make('Roles', 'roles', null, 'description'),
        PermissionBooleanGroup::make('Permissions', 'permissions', null, 'description'),
        RoleSelect::make('Role', 'roles', null, 'description'),
    ];
}
```

Define Policies
---------------

[](#define-policies)

```
// in app/Providers/NovaServiceProvider.php

// ...

public function tools()
{
    return [
        // ...
        \CodeHeroMX\NovaPermission\NovaPermissionTool::make()
            ->rolePolicy(RolePolicy::class)
            ->permissionPolicy(PermissionPolicy::class),
    ];
}
```

Usage
-----

[](#usage)

A new menu item called "Permissions &amp; Roles" will appear in your Nova app after installing this package.

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 59.4% of commits — single point of failure

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1218d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/35c1c6e446fbc2a96e779a2a073bc1127fe1410e833c7e52611f3450a7bec58b?d=identicon)[iBet7o](/maintainers/iBet7o)

---

Top Contributors

[![vyuldashev](https://avatars.githubusercontent.com/u/1809081?v=4)](https://github.com/vyuldashev "vyuldashev (98 commits)")[![iBet7o](https://avatars.githubusercontent.com/u/590235?v=4)](https://github.com/iBet7o "iBet7o (12 commits)")[![nalingia](https://avatars.githubusercontent.com/u/5793125?v=4)](https://github.com/nalingia "nalingia (6 commits)")[![sp4r74cus](https://avatars.githubusercontent.com/u/864292?v=4)](https://github.com/sp4r74cus "sp4r74cus (6 commits)")[![Reflow1319](https://avatars.githubusercontent.com/u/6665500?v=4)](https://github.com/Reflow1319 "Reflow1319 (5 commits)")[![gnanakeethan](https://avatars.githubusercontent.com/u/2353181?v=4)](https://github.com/gnanakeethan "gnanakeethan (4 commits)")[![SiebeVE](https://avatars.githubusercontent.com/u/14889418?v=4)](https://github.com/SiebeVE "SiebeVE (3 commits)")[![shalawani](https://avatars.githubusercontent.com/u/7045417?v=4)](https://github.com/shalawani "shalawani (3 commits)")[![erhansogut](https://avatars.githubusercontent.com/u/1370493?v=4)](https://github.com/erhansogut "erhansogut (2 commits)")[![johnpaulmedina](https://avatars.githubusercontent.com/u/1139439?v=4)](https://github.com/johnpaulmedina "johnpaulmedina (2 commits)")[![philipgunther](https://avatars.githubusercontent.com/u/15112900?v=4)](https://github.com/philipgunther "philipgunther (2 commits)")[![letrams](https://avatars.githubusercontent.com/u/6623497?v=4)](https://github.com/letrams "letrams (2 commits)")[![drbyte](https://avatars.githubusercontent.com/u/404472?v=4)](https://github.com/drbyte "drbyte (2 commits)")[![IGedeon](https://avatars.githubusercontent.com/u/694313?v=4)](https://github.com/IGedeon "IGedeon (2 commits)")[![tyler-rehm](https://avatars.githubusercontent.com/u/8682798?v=4)](https://github.com/tyler-rehm "tyler-rehm (1 commits)")[![vincenzoraco](https://avatars.githubusercontent.com/u/5623078?v=4)](https://github.com/vincenzoraco "vincenzoraco (1 commits)")[![Melvintehu](https://avatars.githubusercontent.com/u/5984622?v=4)](https://github.com/Melvintehu "Melvintehu (1 commits)")[![dercodercom](https://avatars.githubusercontent.com/u/16963738?v=4)](https://github.com/dercodercom "dercodercom (1 commits)")[![dnwjn](https://avatars.githubusercontent.com/u/57711725?v=4)](https://github.com/dnwjn "dnwjn (1 commits)")[![fkeloks](https://avatars.githubusercontent.com/u/16477784?v=4)](https://github.com/fkeloks "fkeloks (1 commits)")

---

Tags

laravelnovaspatie-permission

### Embed Badge

![Health badge](/badges/codehero-mx-nova-permission-tool/health.svg)

```
[![Health](https://phpackages.com/badges/codehero-mx-nova-permission-tool/health.svg)](https://phpackages.com/packages/codehero-mx-nova-permission-tool)
```

###  Alternatives

[vyuldashev/nova-permission

A Laravel Nova tool for Spatie's Permission library.

4302.6M3](/packages/vyuldashev-nova-permission)[kiritokatklian/nova-permission

A Laravel Nova tool for Spatie's Permission library.

791.2M4](/packages/kiritokatklian-nova-permission)[sereny/nova-permissions

Laravel Nova - Roles &amp; Permissions

87455.9k1](/packages/sereny-nova-permissions)[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17878.9k](/packages/markwalet-nova-modal-response)[itsmejoshua/novaspatiepermissions

Laravel Nova tool for managing spaties roles/permissions in laravel's nova package.

30272.1k](/packages/itsmejoshua-novaspatiepermissions)

PHPackages © 2026

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