README

QuickAdmin is a web-based starter kit to help to start a large application without thinking about authentication, authorization, and role-based permission.

• The codebase is structured by a Repository pattern.
• Laravel Ui is used for authentication.

QuickAdmin is accessible, powerful, and provides tools required for large, robust applications.

Prerequisite

• PHP >= 8.1

Getting Started

• First clone the project and change the directory

git clone https://github.com/wahid09/QuickAdmin.git
cd QuickAdmin

• Install Dependencies

1. install composer

composer install

1. Copy .env.example to .env

cp .env.example .env

1. Generate application key

php artisan key:generate

1. Databse migrations

php artisan migrate:refresh --seed

1. Start the webserver

php artisan serve

Super Admin Login

• Email: admin@admin.com
• Password: password

Role and Permission:

The QuickAdmin provides dynamic ACL in a single action of every user. To achieve this functionality use the below code in your controller method.

Gate::authorize('permission slug');

e.g

public function store(ModuleRequest $request){
       Gate::authorize('module-create');
        //code
}

Blade directive for sidebar menu control.

@permission('permission slug')
//code
@endpermission

User log activity control:

To track the record of user activity using the below code in every action method in your controller.

\LogActivity::addToLog('user action');

License

The QuickAdmin is open-sourced software licensed under the MIT license.