README

The project starter is a seed for Laravel web applications. The project contains a sample application and it is pre-configured to install bunch of front-end and back-end tools that helps to setup new projects. We suggest to use Homestead vagrant box for your local environment, because the project starter contains environment specific configurations and scripts. Also homestead helps when working in a team and you have to use the same local environments. For more information on how to install Homestead check out this tutorial from laracasts.

Default Dependencies

Backend

• laravel/framework": 4.2.* - Can't be Laravel project starter without Laravel
• watson/validating: 0.10.* - Validation package
• cartalyst/sentry: 2.1.* - Authorization and authentication package
• sleeping-owl/admin: 1.", - Customizable Administration Panel
• fzaninotto/faker: v1.3.0 - PHP library that generates fake data
• barryvdh/laravel-debugbar": ~1.8 - Debugbar for Laravel
• way/generators: ~2.0 - Variety of generators for models, scaffolds, controllers etc.

Frontend (Bower Dependencies)

• modernizr: 2.8.x - Modernizr is a JavaScript library that detects HTML5 and CSS3 features in the user’s browser.
• jquery: 2.x.x - jQuery is a fast, small, and feature-rich JavaScript library. It makes things like HTML document traversal and manipulation, event handling, animation, and Ajax
• fastclick: ~1.0.6 - FastClick is a simple, easy-to-use library for eliminating the 300ms delay between a physical tap and the firing of a click event on mobile browsers.

Features

• Different environments setup
• Automatic DB settings based on project name
• Custom error pages
• Default behaviour for model validation exceptions
• Custom model validation
• Debug bar
• Authentication and Users/Roles handled with Sentry
• Creation of DB, running migrations and seeding data for default users and roles

Installation

To install the project you should run the following command in the Homestead:

$ composer create-project despark/laravel-project-starter <project_name>

Where project_name is the name of the project that you want to start.

What command does?

• Create database with the entered project_name, setup the migrations
• Setup the migration table
• Migrate and seed the users table
• Publish configurations
• Change placeholders that contains name of the project in configuration files

Frontend installation and running

To complete the next step you should have installed Bower & Npm manager. If no:

• Download and install Node.js

Than:

• $ npm install -g bower

Run the following commands to install the dependecies

• bower install
• npm install

For building and watching sass, js, image and fonts files run the following command

• gulp

Frontend dev folder is static_html. The result is delivered in public folder.