[go: up one dir, main page]
Scribd
Upload
105 views6 pages

Boilerplate

This document summarizes the Laravel-boilerplate project on GitHub. It provides a starter kit for building Laravel applications with features like an admin dashboard, social login integration, user authentication, and more. The project uses Docker for a flexible local development environment and provides documentation on installation, configuration, and contributing to the project.

Uploaded by

rubinson
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as TXT, PDF, TXT or read online on Scribd
105 views6 pages

Boilerplate

This document summarizes the Laravel-boilerplate project on GitHub. It provides a starter kit for building Laravel applications with features like an admin dashboard, social login integration, user authentication, and more. The project uses Docker for a flexible local development environment and provides documentation on installation, configuration, and contributing to the project.

Uploaded by

rubinson
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as TXT, PDF, TXT or read online on Scribd
You are on page 1/ 6

Skip to content

Why GitHub?

Enterprise
Explore

Marketplace
Pricing

Sign in
Sign up

51
447

198

Labs64/laravel-boilerplate
Code
Issues 2
Pull requests 1
Projects 0
Wiki
Security
Insights
Join GitHub today

GitHub is home to over 36 million developers working together to host and review
code, manage projects, and build software together.
Laravel 5 Boilerplate / Starter kit with Gentelella Admin Theme
https://github.com/Labs64/laravel-boi�
php
laravel
laravel5
admin
bootstrap
twitter
laravel-boilerplate
social-login
framework
theme
docker
boilerplate
template
starter
nodejs
responsive
font-awesome
docker-compose
starter-kit
open-source-friday

230 commits
1 branch
6 releases
4 contributors

MIT

PHP 76.6% HTML 22.5% Other 0.9%

@v-rudkovskiy
v-rudkovskiy update laravel to v5.8
Latest commit 784aec5 17 hours ago
Type Name Latest commit message Commit time
app update laravel to v5.8 17 hours ago
bootstrap Create .gitkeep 2 years ago
config update laravel to v5.8 17 hours ago
database update laravel to v5.8 17 hours ago
dockerfiles Delete docker-clean-all.sh 2 years ago
public update laravel to v5.8 17 hours ago
resources update laravel to v5.8 17 hours ago
routes update laravel to v5.8 17 hours ago
storage Delete .gitignore 2 years ago
tests - add migrations social_accounts, roles, permissions 2 years ago
.env.example update laravel to v5.8 17 hours ago
.gitattributes - add migrations social_accounts, roles, permissions 2
years ago
.gitignore Remove bower 2 years ago
.travis.yml Update .travis.yml 2 years ago
CONTRIBUTE.md Update CONTRIBUTE.md 2 years ago
LICENSE Initial commit 2 years ago
README.md Update README.md 9 months ago
artisan - add migrations social_accounts, roles, permissions 2 years ago
composer.json update laravel to v5.8 17 hours ago
docker-compose.utils.yml - split base and utils docker compose
configuration 2 years ago
docker-compose.yml - split base and utils docker compose configuration
2 years ago
package-lock.json update laravel to v5.8 17 hours ago
package.json Issue #24 Upgrade Gentelella to the1.4.0 version 2
years ago
phpunit.xml - add migrations social_accounts, roles, permissions 2
years ago
server.php - add migrations social_accounts, roles, permissions 2 years ago
webpack.mix.js Issue #30 Fix jQuery.Deferred exception 2 years ago
README.md

Build Status PHP Badge Latest Stable Version Total Downloads License Stories in
Ready
Laravel 5 Boilerplate Project

Laravel Boilerplate provides a very flexible and extensible way of building your
custom Laravel 5 applications.
Table of Contents

Features
Theme Demo
System Requirements
Installation
Run
Docker ??
How To's & Modules configuration
How to contribute
Bugs and Feedback
License

Features

Administration Dashboard with Gentelella Admin Theme


Responsive Layout
Bootstrap 3
Font Awesome
Socialite Integration
Invisible reCAPTCHA
Membership plans and Access control management by NetLicensing ??
MySQL, SQLite, PostgreSQL databases support
AWS S3 support
Google Analytics support in frontend
Configuration can be easily made via analytics.php and template
ga.blade.php
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 :)

Theme Demo

Gentelella Bootstrap Admin Template


Gentelella Admin Theme Demo
System Requirements

To be able to run Laravel Boilerplate you have to meet the following requirements:

PHP > 7.1


PHP Extensions: PDO, cURL, Mbstring, Tokenizer, Mcrypt, XML, GD
Node.js > 6.0
Composer > 1.0.0

Installation

Install Composer using detailed installation instructions here

$ wget https://getcomposer.org/composer.phar
$ chmod +x composer.phar
$ mv composer.phar /usr/local/bin/composer

Install Node.js using detailed installation instructions here

$ yum install npm

Clone repository

$ git clone https://github.com/Labs64/laravel-boilerplate.git

Change into the working directory

$ cd laravel-boilerplate

Copy .env.example to .env and modify according to your environment

$ cp .env.example .env

Install composer dependencies

$ composer install --prefer-dist

An application key can be generated with the command

$ php artisan key:generate

Execute following commands to install other dependencies

$ npm install
$ npm run dev

Run these commands to create the tables within the defined database and
populate seed data

$ php artisan migrate --seed

Troubleshooting

If you get an error like a PDOException try editing your .env file and change
DB_HOST=127.0.0.1 to DB_HOST=localhost or DB_HOST=mysql (for docker-compose
environment).

If you get a password error try this command:


# ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'root';

Run

To start the PHP built-in server

$ php artisan serve --port=8080


or
$ php -S localhost:8080 -t public/

Now you can browse the site at http://localhost:8080 ??


Docker

Here is a Docker based local development environment prepared, which provides a


very flexible and extensible way of building your custom Laravel 5 applications.
What's Inside

This project is based on docker-compose. By default, the following containers are


started: laravel-env (centos:7 based), mysql, nginx. Additional containers
(phpmyadmin, mailhog) are externalized into docker-compose.utils.yml. The
/var/www/laravel-boilerplate 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.

Laravel Boilerplate Docker


System Requirements

To be able to run Laravel Boilerplate you have to meet the following requirements:

docker
docker-compose

Run

Clone repository

$ git clone https://github.com/Labs64/laravel-boilerplate.git

Copy .env.example to .env and modify according to your environment (make sure
database host set to DB_HOST=mysql)

$ cp .env.example .env

Start environment

$ docker-compose up -d # to start base containers


or
$ docker-compose -f docker-compose.yml -f docker-compose.utils.yml up -d # to
start base and utils containers

Build project

$ docker exec laravel-boilerplate_laravel-env_1 ./dockerfiles/bin/prj-build.sh


or
$ docker-compose run --rm laravel-boilerplate_laravel-env_1 ./dockerfiles/bin/prj-
build.sh

Now you can browse the site at http://localhost:80 ??


Stop environment

$ docker-compose down
or
$ docker-compose -f docker-compose.yml -f docker-compose.utils.yml down

How To's & Modules configuration

Check out project wiki pages for modules configuration and troubleshooting. For
more detailed instructions on how to use Laravel and it's extensions, check out the
full Laravel documentation.
How to contribute

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!
Contributors and Supporters

Thank you to all the contributors on this project. Your help is much appreciated!

Photolancer Zone team for a great support in project structuring.


DigiPass Laravel - Membership pricing plans and Access control management for
Laravel

Bugs and Feedback

For bugs, questions and discussions please use the GitHub Issues.
License

This boilerplate is open-sourced software licensed under the MIT license.

� 2019 GitHub, Inc.


Terms
Privacy
Security
Status
Help

Contact GitHub
Pricing
API
Training
Blog
About

You might also like