Development

Whether you are a front-end or backend developer the below steps are required.

• Set Up Laravel Homestead. From this point onwards, you should ssh into this virtual machine, and continue with next steps.
• Clone this repo to your development machine
• Generate Laravel key
• Set up Node & NPM
• Install local npm packages npm install
• Use bower to install front-end packages.
• Use composer to install back-end packages.
• Run command gulp --production to minimize and copy all css & js to public directory.
• Run tests using phpunit
• Run migrations

Software required on Web Server

• Bower | Dependency manager for front-end libraries.
• Composer | Dependency Manager for PHP
• Git | Git is a widely used version control system for software development.

Testing

• Input testing credentials as found on .env.example
• Run test based on Laravel framework: php artisan migrate:refresh --database mysql_testing

Codeception

Laravel framework does not support async testing. Thus we need to use codeception.

Set Up

1. Download headless browser server PhantomJS
2. Run this server: phantomjs --webdriver=4444

Add credentials

• Create environment variables using the .env.example.
  • Use the php artisan key:generate command for the 'APP_KEY' variable.

Set Up Database

• php artisan migrate:refresh --database=mysql_testing Drops and creates tables
• php artisan db:seed --class=RequiredTableSeeder --database=mysql_testing Seed testing database with required initial data.

CSS/SCSS

• SASS Guide & Laravel elixir
  • Use gulp watch --production. Generates & minifies css files from resources/assets/sass/ directory amongst other things.

Tests

• phpunit Runs all tests.
  • Use gulp watch --production. Runs tests each time you save the source code amongst other things.

Credits

• Bower | Web sites are made of lots of things — frameworks, libraries, assets, and utilities. Bower manages all these things for you.
• Composer | Dependency Manager for PHP
• Git | Git (/ɡɪt/) is a widely used version control system for software development.
• fzaninotto/Faker | Faker is a PHP library that generates fake data for you
• GrahamCampbell/Laravel-HTMLMin A simple HTML minifier for Laravel 5 https://gjcampbell.co.uk/