Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/FTXInfotech/laravel-adminpanel

A Laravel Admin Panel (Laravel Version : 6.0)
https://github.com/FTXInfotech/laravel-adminpanel

adminlte api-boilerplate api-boilerplate-jwt hacktoberfest hacktoberfest2020 laravel laravel-admin laravel-admin-panel laravel-adminlte laravel-adminpanel laravel-boilerplate laravel-passport php rest-api vuejs

Last synced: about 2 months ago
JSON representation

A Laravel Admin Panel (Laravel Version : 6.0)

Awesome Lists containing this project

README

        

## Laravel Admin Panel (Current: Laravel 7.*)

[![StyleCI](https://styleci.io/repos/105789824/shield?style=plastic)](https://github.styleci.io/repos/105789824)
![GitHub contributors](https://img.shields.io/github/contributors/FTXInfotech/laravel-adminpanel.svg)
![GitHub stars](https://img.shields.io/github/stars/FTXInfotech/laravel-adminpanel.svg?style=social)

### Introduction
---
Laravel Admin Panel provides you with a massive head start on any size web application. It comes with a full featured access control system out of the box with an easy to learn API and is built on a Bootstrap foundation with a front and backend architecture. We have put a lot of work into it and we hope it serves you well and saves you time!

* The project is based on the [Rappasoft Laravel Boilerplate](https://github.com/rappasoft/laravel-boilerplate/releases/tag/v6.0.1), with enhancements and many modules pre-made, just for you.
* Article on our Admin Panel on CodeWall : [https://www.codewall.co.uk/the-laravel-admin-panel-that-you-need/](https://www.codewall.co.uk/the-laravel-admin-panel-that-you-need/)
* MIT: [http://anthony.mit-license.org](http://anthony.mit-license.org)

### Setup
---
Clone the repo and follow below steps.
1. Run `composer install`
2. Copy `.env.example` to `.env` Example for linux users : `cp .env.example .env`
3. Set valid database credentials of env variables `DB_DATABASE`, `DB_USERNAME`, and `DB_PASSWORD`
4. Run `php artisan key:generate` to generate application key
5. Run `php artisan migrate`
6. Run `php artisan passport:install`
7. Run `php artisan db:seed` to seed your database
7. Run `npm i` (Recommended node version `>= V10.0`)
8. Run `npm run dev` or `npm run prod` as per your environment

Thats it... Run the command `php artisan serve` and cheers, you are good to go with your new **Laravel Admin Panel** application.

### Using docker to run the application
---
1. `docker-compose build`
2. `docker/cli composer install`
3. `docker/cli php artisan key:generate`
4. `docker/cli php artisan migrate`
5. `docker/cli php artisan passport:install`
6. `docker/cli php artisan db:seed`
7. `docker/npm i`
8. `docker/npm run dev`
9. `docker-compose up -d`

You can login to docker cli using the command `docker exec -ti ls-www /bin/bash`

*Note: Please make sure that you have proper permissions when setting up the project via docker.*

---
The application uses [GrumPHP](https://github.com/phpro/grumphp) for the git pre-commit hook and [PHPCSFixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer) for the code standards. You can also bypass the `GrumPHP` pre-commit hook by hitting `git commit -n` or `git commit --no-verify`

### Demo Credentials
---
*Make sure you have run the command `php artisan db:seed --class UserTableSeeder` before you use these credentials.*

**User:** [email protected]\
**Password:** 1234

**User:** [email protected]\
**Password:** 1234

**User:** [email protected]\
**Password:** 1234

### Useful Commands
---
+ To format your code: `composer format`
+ To run the test cases: `./vendor/bin/phpunit`
+ The test cases report will be placed in the `reports` directory
+ To generate scribe API documentation: `php artisan scribe:generate`
+ Documentation will be generated and placed in the `public/docs` directory

## ScreenShots

## Dashboard
![Screenshot](screenshots/dashboard.png)

## User Listing
![Screenshot](screenshots/users.png)

## Log Viewer
![Screenshot](screenshots/log-viewer.png)

## Issues
If you come across any issues please report them [here](https://github.com/FTXInfotech/laravel-adminpanel/issues).

## Contribution
Feel free to create any pull requests for the project. For proposing any new changes or features you want to add to the project, you can send us an email at following addresses.

1. Alan Whitmore - [email protected]
2. Vicky Patel - [email protected]