Bodom78 / laravel5-angular-material-starter

Laravel 5 angular material starter project

Laravel 5.1 Angular Material Starter

Version 2.10

View DEMO

Table of Contents

Overview
Installation
Issues, questions and feature requests
Planned features
Upcoming Version 3
Do It Yourself
Contributing

OVERVIEW

This is a starter project that gives you an out of the box configuration Laravel 5.1 and AngularJS (folder by feature architecture). Here are the goodies that you'll get:

• Laravel 5.1
• Angular
• Angular Material
• Blazing fast Elixir 3.0 configuration with custom tasks
• artisan generators for angular (artisan ng:feature name, artisan ng:dialog name, etc..)
• check out the full list of features

Installation

Heads up for Windows + Vagrant users: Start by applying the fix in issue #61

composer create-project jadjoubran/laravel5-angular-material-starter --prefer-dist
cd laravel5-angular-material-starter
#fix database credentials in .env
npm install -g gulp bower
npm install
bower install
php artisan migrate
gulp && gulp watch
php artisan serve

• You're ready to go! http://localhost:8000
• Star the repo and submit your feedback as a new issue or to @JoubranJad

Issues, questions and feature requests

Open a new issue, I'd love to help.

Planned features

Moved to github issues.

Upcoming Version 3

Development of Version 3 is ongoing.
In version 3, Laravel Angular Material Starter aims to be the starting point of future Laravel & Angular apps. We won't be including a library or a behavior by default, unless we're sure that this is something absolutely necessary. We're also moving towards a recipes/plugins architecture to come up with easy solutions for common scenarios (SEO, Web Sockets, etc).

If you're interested in following the progress or testing new features, checkout the official trello board.

Do It Yourself

A nice article on sitepoint that explains the first few versions of this repository. Recommended read if you're not familiar with the underlying technologies.

Contributing

Thank you for contributing to this repository.

Here are the guidelines:

#setup jshint
npm install -g jshint

1. run jshint angular/**/*.js to make sure that your javascript code is linted.
2. run gulp --production at the end if you changed any HTML, Less or JS. Do not send Pull Requests without running this command (unless you haven't touched the frontend)
3. delete .map files rm public/css/app.css.map public/css/vendor.css.map public/js/app.map public/js/vendor.js.map
4. If you are adding/modifying backend functionality, make sure to include the apprioriate test. Let me know if you need help writing the test