PHPackages                             kolyayurev/voyager - 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. [Admin Panels](/categories/admin)
4. /
5. kolyayurev/voyager

ActiveLibrary[Admin Panels](/categories/admin)

kolyayurev/voyager
==================

A Laravel Admin Package for The Control Group, fork by kolyayurev

1.22.11(2y ago)121MITPHP

Since Mar 26Pushed 2y ago1 watchersCompare

[ Source](https://github.com/kolyayurev/voyager)[ Packagist](https://packagist.org/packages/kolyayurev/voyager)[ Docs](https://voyager.devdojo.com/)[ RSS](/packages/kolyayurev-voyager/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (14)Versions (116)Used By (0)

[![](https://camo.githubusercontent.com/ceeec0cf14351e3a25e3cef5426dd36d7749cc00650df3ad1920c0ae241046ed/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f746865636f6e74726f6c67726f75702f766f79616765722e706e67)](https://the-control-group.github.io/voyager/)

**V**oyager - The Missing Laravel Admin
=======================================

[](#voyager---the-missing-laravel-admin)

Made with ❤️ by [The Control Group](https://www.thecontrolgroup.com)

[![Voyager Screenshot](https://camo.githubusercontent.com/db4ab326d29dcd7ba338cfdb211d80468c31b2ce211b45b606637059d2f89c75/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f746865636f6e74726f6c67726f75702f766f79616765722d73637265656e73686f742e706e67)](https://camo.githubusercontent.com/db4ab326d29dcd7ba338cfdb211d80468c31b2ce211b45b606637059d2f89c75/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f746865636f6e74726f6c67726f75702f766f79616765722d73637265656e73686f742e706e67)

Website &amp; Documentation:

Local [documentation](./docs/summary.md).

Video Tutorial Here:

---

Laravel Admin &amp; BREAD System (Browse, Read, Edit, Add, &amp; Delete), supporting Laravel 8 and newer!

Installation Steps
------------------

[](#installation-steps)

### 1. Require the Package

[](#1-require-the-package)

After creating your new Laravel application you can include the Voyager package with the following command:

```
composer require kolyayurev/voyager
```

### 2. Add the DB Credentials &amp; APP\_URL

[](#2-add-the-db-credentials--app_url)

Next make sure to create a new database and add your database credentials to your .env file:

```
DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

```

You will also want to update your website URL inside of the `APP_URL` variable inside the .env file:

```
APP_URL=http://localhost:8000

```

### 3. Run The Installer

[](#3-run-the-installer)

Lastly, we can install voyager. You can do this either with or without dummy data. The dummy data will include 1 admin account (if no users already exists), 1 demo page, 4 demo posts, 2 categories and 7 settings.

To install Voyager without dummy simply run

```
php artisan voyager:install
```

If you prefer installing it with dummy run

```
php artisan voyager:install --with-dummy
```

And we're all good to go!

Start up a local development server with `php artisan serve` And, visit .

Creating an Admin User
----------------------

[](#creating-an-admin-user)

If you did go ahead with the dummy data, a user should have been created for you with the following login credentials:

> **email:** `admin@admin.com`
> **password:** `password`

NOTE: Please note that a dummy user is **only** created if there are no current users in your database.

If you did not go with the dummy user, you may wish to assign admin privileges to an existing user. This can easily be done by running this command:

```
php artisan voyager:admin your@email.com
```

If you did not install the dummy data and you wish to create a new admin user you can pass the `--create` flag, like so:

```
php artisan voyager:admin your@email.com --create
```

And you will be prompted for the user's name and password.

Front Control Panel
-------------------

[](#front-control-panel)

Add `admin-controls-expanded` cookie to `EncryptCookies` middleware

Custom fields
-------------

[](#custom-fields)

Model must have function

```

public function adminFields():array{

     return [
      'meta_1' => [
          "name" => "meta_1",
          "type" => "varchar",
          "null" => "YES",
          "field" => "timestamp",
          "key" => null,
          // OTHERS
          "default" => null,
          "notnull" => false,
          "length" => 0,
          "precision" => 10,
          "scale" => 0,
          "fixed" => false,
          "unsigned" => false,
          "autoincrement" => false,
          "columnDefinition" => null,
          "comment" => null,
          "oldName" => "timestamp",
          "extra" => "",
          "composite" => false,
          "indexes" => [],
      ],
     ];
    }

```

And setter and getter

```
    public function setOptionsAttribute($value)
    {
        $this->attributes['options'] = json_encode($value);
    }

    public function getOptionsAttribute($value)
    {
        return json_decode(!empty($value) ? $value : '{}');
    }

    public function setMeta1Attribute($value)
    {
        $this->attributes['options'] = collect($this->options)->merge(['meta_1' => $value]);
    }
    public function getMeta1Attribute()
    {
        return $this->options->meta_1 ?? null;
    }

```

Custom breads
-------------

[](#custom-breads)

You must enter a unique slug and specify the model for BREAD.

Example slug: `feedback-client`, model: `App\Models\FeedbackClient`

> But first you have to create a model

Model must have next code

```

public static function boot(){
    parent::boot();
    static::creating(function ($model) {
        $model->type = 'client';
    });
    static::addGlobalScope('client', function($builder){
        $builder->where('type', 'client');
    });
}

```

Import seeder
-------------

[](#import-seeder)

```
php artisan db:seed --class=VoyagerBreadFeedbacksSeeder

```

Next, you need go to imported bread edit page and save. Voyager will generate permissions and then you need to give the roles access to this BREAD.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~7 days

Recently: every ~25 days

Total

115

Last Release

1082d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/805028c2244098cc06f81d745f7936f7c021d1a609d4d5e32bbc039c69c29c0d?d=identicon)[kolyayurev](/maintainers/kolyayurev)

---

Top Contributors

[![kolyayurev](https://avatars.githubusercontent.com/u/56155627?v=4)](https://github.com/kolyayurev "kolyayurev (295 commits)")

---

Tags

laraveladminpanel

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kolyayurev-voyager/health.svg)

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

PHPackages © 2026

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