Laravel Boilerplate provides a very flexible and extensible way of building your custom Laravel 5 applications.
- Administration Dashboard with Gentelella Admin Theme
- Responsive Layout
- Bootstrap 3
- Font Awesome
- Socialite Integration
- MySQL, SQLite, PostgreSQL databases support
- AWS S3 support
- Google Analytics support in frontend
- Configuration can be easily made via
analytics.php
and templatega.blade.php
- Configuration can be easily made via
- Automatic errors feedback via eMail
- i18n support and automatic user client language recognition
- Helper class
ToJs
to ease work with JavaScript variables using blade directive@tojs
- Helper class
Meta
blade directive@meta
to ease work with meta tags & properties - Models for Users and Roles
- Added Auth controller to allow registration activation by email
- Extended Auth configuration by:
- Ability to switch on/off user registration
- Set up default user role
- Ability to switch on/off registration activation email
- Captcha configuration
- Gravatar support in User model and flexible configuration via
gravatar.php
- Added library log viewer to allow printing errors in a log file
laravel.log
- Added library sortable for tables sorting
- i18n:
trans()
method replaced by__()
in order to support internationalization via JSON resources - Registration using social services (Google+, Facebook, Twitter)
- Storing last social login in user session
- Added event on SocialLogin
- Added listeners on some events; e.g. Login, Logout, Registration, SocialLogin
- Added notification
ConfirmEmail
on user account confirmation - Added policies to access backend services
- Added database seeders for Users, Roles, and UserRoles
- Improved migration
create_users_table.php
; fields added active, confirm and deleted_at for soft deletion - JavaScript / CSS minification
- JavaScript / CSS hashing
- Some very useful helper functions to ease your live :)
To be able to run Laravel Boilerplate you have to meet the following requirements:
- PHP > 5.6.4
- PHP Extensions: PDO, cURL, Mbstring, Tokenizer, Mcrypt, XML, GD
- Node.js > 6.0
- Composer > 1.0.0
- Bower
- Install Composer using detailed installation instructions here
- Install Node.js using detailed installation instructions here
- Clone repository
$ git clone https://github.com/Labs64/laravel-boilerplate.git
- Change into the working directory
$ cd laravel-boilerplate
- Install dependencies
$ composer install --prefer-dist
$ npm install
- Edit
.env.example
according to your environment and save as.env
- An application key can be generated with the command
$ php artisan key:generate
- Execute following commands
$ bower install
$ npm run dev
- Run these commands to create the tables within the defined database and populate seed data
$ php artisan migrate --seed
If you get an error like a PDOException
try editing your .env
file and change DB_HOST=localhost
to DB_HOST=127.0.0.1
.
To start the PHP built-in server
$ php -S localhost:8080 -t public/
Now you can browse the site http://localhost:8080 🙌
Tere is a Docker based local development environment prepared, which provides a very flexible and extensible way of building your custom Laravel 5 applications.
This project is based on docker-compose. By default, the following containers are started: laravel-env, mysql, nginx. The /laravel
directory is the web root which is mapped to the nginx container.
You can directly edit configuration files from within the repo as they are mapped to the correct locations in containers.
To be able to run Laravel Boilerplate you have to meet the following requirements:
Clone repository
$ git clone https://github.com/Labs64/laravel-boilerplate.git
To start environment
$ docker-compose up -d
Now you can browse the site http://localhost:80 🙌
To stop environment
$ docker-compose down
List docker processes
$ docker ps
List docker processes
$ docker exec -it <CONTAINER ID|CONTAINER NAME> bash
Verify available databases
# mysql -u root -p laravel_boilerplate
mysql> show databases;
Remove all docker-compose images
$ docker-compose rm -v
Fork the repository, read the CONTRIBUTE file and make some changes. Once you're done with your changes send a pull request and check CI validation status. Thanks!
For bugs, questions and discussions please use the GitHub Issues.
This boilerplate is open-sourced software licensed under the MIT license.