About Laravel Quick-Start
Laravel Quickstart is a boilerplate for Laravel Application with typical packages preinstalled and configured to extend a full-fledged application. We tried to make it as minimal as possible.
Here are some of its features:
- Separate Views, Routes, Controllers directories for Frontend(Public Interface) and Backend(Admin Interface)
- Both Frontend and Backend utilizes TailwindCSSv3 as frontend framework
- User Management Laravel Fortify package, with social login Socialite and Roles and Permissions Spatie Laravel Permissions package
- Integrated Log Viewer
We are trying to make the package easier to deploy.
How to Install
1. Download Laravel-QuickStart
Choose your preferred method
- Download Zipped Archive.
- Clone from GitHub
git clone https://github.com/developervijay7/laravel-quickstart.git
2. Setup .env file
Laravel-QuickStart has a .env.example file in the root of the project.
Rename .env.example to .env make sure that the .env file must be in root directory. Open .env file in your preferred choice of editor and add database credentials.
Database configuration
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=password
Also, don't forget to set up mail configuration.
MAIL_MAILER=smtp
MAIL_HOST=mailhog
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="[email protected]"
MAIL_TO_ADDRESS="${APP_NAME}"
Note: Make sure your operating system is not configured to display hidden files to show .env file.
3. Composer
In order to install php composer dependencies you first need to set up composer on your operating system. Once your system is compatible with php composer run the following command in your Terminal/ Windows Command Prompt/ Windows powershell/ git bash.
composer install
4. Generate Application Keys
This will set your APP_KEY in your .env file
php artisan key:generate
5. Migrate Database
php artisan migrate
if you also want to import demo users, permissions, and roles run:
php artisan db:seed
6. NPM/Yarn
In order to install JavaScript dependencies in your application you will need to install Node Package Manager and optionally you can use yarn to install them.
Once you have NPM installed run this command npm install
or if you want to install using yarn run: yarn
7. NPM run prod/dev
If you are deploying Laravel-QuickStart on your production environment run:
npm run prod
If you are deploying it on your local development computer run:
npm run dev
8. Demo Credentials
Master: [email protected]
Password: M@aster
Admin: [email protected]
Password: Adm!n
User: [email protected]
Password: Us@r
##Official Documentation Laravel-QuickStart Documentation
Contributing
Thank you for considering contributing to the Laravel Quick-Start project! Please feel free to make any pull requests, or e-mail me a feature request you would like to see in the future to James L Masi at [email protected].
License
The Laravel framework is open-sourced software licensed under the MIT license.