Home

Awesome

<p align="center"><img src="https://laravel.com/assets/img/components/logo-laravel.svg"></p> <p align="center"> <a href="https://travis-ci.org/Labs64/laravel-boilerplate"><img src="https://travis-ci.org/Labs64/laravel-boilerplate.svg" alt="Build Status"></a> <a href="https://laravel.com"><img src="https://img.shields.io/badge/Laravel-v8-f05340.svg" alt="Laravel Version"></a> <a href="https://github.com/Labs64/laravel-boilerplate/blob/master/composer.json"><img src="https://img.shields.io/badge/php-%3E%3D%207.2.5-8892BF.svg" alt="PHP Badge"></a> <a href="https://packagist.org/packages/labs64/laravel-boilerplate"><img src="https://poser.pugx.org/labs64/laravel-boilerplate/v/stable.svg" alt="Latest Stable Version"></a> <a href="https://packagist.org/packages/labs64/laravel-boilerplate"><img src="https://poser.pugx.org/labs64/laravel-boilerplate/d/total.svg" alt="Total Downloads"></a> <a href="https://packagist.org/packages/labs64/laravel-boilerplate"><img src="https://poser.pugx.org/labs64/laravel-boilerplate/license.svg" alt="License"></a> </p>

Laravel Boilerplate Project

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

Table of Contents

Features

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:

Installation

  1. Install Composer using detailed installation instructions here
    wget https://getcomposer.org/composer.phar
    
    chmod +x composer.phar
    
    mv composer.phar /usr/local/bin/composer
    
  2. Install Node.js using detailed installation instructions here
    yum install npm
    
  3. Clone repository
    git clone https://github.com/Labs64/laravel-boilerplate.git
    
  4. Change into the working directory
    cd laravel-boilerplate
    
  5. Copy .env.example to .env and modify according to your environment
    cp .env.example .env
    
  6. Install composer dependencies
    composer install --prefer-dist
    
  7. An application key can be generated with the command
    php artisan key:generate
    
  8. Execute following commands to install other dependencies
    npm install
    
    npm run dev
    
  9. Run these commands to create the tables within the defined database and populate seed data
    php artisan migrate --seed
    

Troubleshooting

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 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.

<p align="center"><img src="https://raw.githubusercontent.com/Labs64/laravel-boilerplate/master/dockerfiles/img/laravel-boilerplate-docker.png" alt="Laravel Boilerplate Docker"></p>

System Requirements

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

Run

  1. Clone repository

    git clone https://github.com/Labs64/laravel-boilerplate.git
    
  2. Copy .env.example to .env and modify according to your environment (make sure database host set to DB_HOST=mysql)

    cp .env.example .env
    
  3. 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
    
  4. 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 🙌


  1. 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!

Bugs and Feedback

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

License

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