PHPackages                             nawasara/core - 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 & Authorization](/categories/authentication)
4. /
5. nawasara/core

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

nawasara/core
=============

Core package for Nawasara: authentication via Laravel Fortify, role/permission via Spatie, branding settings, and shared helpers.

v0.3.1(2w ago)044MITPHPPHP ^8.1

Since Sep 26Pushed 2w agoCompare

[ Source](https://github.com/nawasara/core)[ Packagist](https://packagist.org/packages/nawasara/core)[ RSS](/packages/nawasara-core/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (11)Versions (12)Used By (0)

Nawasara Core
=============

[](#nawasara-core)

The core package of the Nawasara superapp framework. Provides authentication, role-based access control, branding configuration, and a `RespectsActiveRole` trait that scopes permission checks to the user's currently active role.

Features
--------

[](#features)

- **Authentication via Laravel Fortify** — login, password reset, two-factor, and email verification, configurable through `nawasara.use_fortify`
- **Role & permission via Spatie** — auto-publishes the Spatie permission migration and registers seeders
- **Active role enforcement** — when a multi-role user "switches" to a specific role from the topbar, all permission checks are scoped to that single role's grants instead of the union of every role they hold
- **Branding settings** — application name, subtitle, logo (light & dark), and favicon, manageable from `/admin/branding`
- **User & role management UI** — Livewire pages for managing users and roles
- **Helpers** — small global helpers in `src/Helpers/functions.php`

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

[](#installation)

```
composer require nawasara/core
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
php artisan migrate
php artisan db:seed --class="Nawasara\Core\Database\Seeders\PermissionSeeder" --force
```

RespectsActiveRole — applying the trait
---------------------------------------

[](#respectsactiverole--applying-the-trait)

Apply the trait on top of Spatie's `HasRoles` in your `App\Models\User`:

```
use Nawasara\Core\Traits\RespectsActiveRole;
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use HasRoles, RespectsActiveRole {
        RespectsActiveRole::hasPermissionTo insteadof HasRoles;
    }
}
```

After this, calling `$user->switchRole('operator')` (or setting `session('active_role', 'operator')`) limits all subsequent permission checks to the `operator` role's permissions for the rest of the session. Direct user-grant permissions still apply.

Pages
-----

[](#pages)

RoutePermission`/nawasara-core/users``core.user.view``/nawasara-core/roles``core.role.view``/nawasara-core/branding``core.branding.manage``/nawasara-core/settings/auth``core.auth.manage``/nawasara-core/settings/email-link``core.email-link.manage`Author
------

[](#author)

**Pringgo J. Saputro** <>

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance97

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99.2% 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

Every ~2 days

Total

8

Last Release

15d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16914951?v=4)[Pringgo J. Saputro](/maintainers/pringgojs)[@pringgojs](https://github.com/pringgojs)

![](https://www.gravatar.com/avatar/edcf770bde3babcc9fa554e305e361b8614c1e505470e75842de75ea3e502548?d=identicon)[nawasara](/maintainers/nawasara)

---

Top Contributors

[![pringgojs](https://avatars.githubusercontent.com/u/16914951?v=4)](https://github.com/pringgojs "pringgojs (119 commits)")[![papa-ree](https://avatars.githubusercontent.com/u/79291092?v=4)](https://github.com/papa-ree "papa-ree (1 commits)")

---

Tags

laravelAuthenticationrbacfortifyspatie-permissionbrandingNawasara

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/nawasara-core/health.svg)

```
[![Health](https://phpackages.com/badges/nawasara-core/health.svg)](https://phpackages.com/packages/nawasara-core)
```

###  Alternatives

[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k3.5M115](/packages/bezhansalleh-filament-shield)[venturedrake/laravel-crm

A free open source CRM built as a package for laravel projects

39910.0k](/packages/venturedrake-laravel-crm)[hasinhayder/tyro

Tyro - The ultimate Authentication, Authorization, and Role & Privilege Management solution for Laravel 12 & 13

6753.6k5](/packages/hasinhayder-tyro)

PHPackages © 2026

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