Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thedevdojo/voyager
Voyager - The Missing Laravel Admin
https://github.com/thedevdojo/voyager
laravel laravel-admin voyager
Last synced: 5 days ago
JSON representation
Voyager - The Missing Laravel Admin
- Host: GitHub
- URL: https://github.com/thedevdojo/voyager
- Owner: thedevdojo
- License: mit
- Created: 2016-10-27T03:56:49.000Z (about 8 years ago)
- Default Branch: 1.6
- Last Pushed: 2024-05-06T10:08:36.000Z (6 months ago)
- Last Synced: 2024-05-19T20:11:12.089Z (6 months ago)
- Topics: laravel, laravel-admin, voyager
- Language: PHP
- Homepage: https://voyager.devdojo.com
- Size: 45.8 MB
- Stars: 11,687
- Watchers: 438
- Forks: 2,666
- Open Issues: 449
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: license
- Security: .github/SECURITY.yml
Awesome Lists containing this project
README
> Voyager is built with Vue and Bootstrap. If you are looking for a Laravel Starter Kit built that uses Livewire and Tailwind, you may be interested in checking out [Genesis](https://github.com/thedevdojo/genesis)
# **V**oyager - The Missing Laravel Admin
Made with ❤️ by [The Control Group](https://www.thecontrolgroup.com)
Website & Documentation: https://voyager.devdojo.com/
Video Tutorial Here: https://voyager.devdojo.com/academy/
Join our Slack chat: https://voyager-slack-invitation.herokuapp.com/
View the Voyager Cheat Sheet: https://voyager-cheatsheet.ulties.com/
Laravel Admin & BREAD System (Browse, Read, Edit, Add, & Delete), supporting Laravel 8 and newer!
> Want to use Laravel 6 or 7? Use [Voyager 1.5](https://github.com/the-control-group/voyager/tree/1.5)
## Installation Steps
### 1. Require the Package
After creating your new Laravel application you can include the Voyager package with the following command:
```bash
composer require tcg/voyager
```
> If you are installing this on Laravel 10, we are working on getting a permanent release available; however, you can still use this with Larvel 10 by requiring the following:
```bash
composer require tcg/voyager dev-1.6-l10
```
### 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
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
```bash
php artisan voyager:install
```
If you prefer installing it with dummy run
```bash
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 [http://localhost:8000/admin](http://localhost:8000/admin).
## 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:** `[email protected]`
>**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:
```bash
php artisan voyager:admin [email protected]
```
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:
```bash
php artisan voyager:admin [email protected] --create
```
And you will be prompted for the user's name and password.