jswhetstone/slim-skeleton-bootstrap

A Slim Framework skeleton application with Bootstrap3; based on Slim-Skeleton by Josh Lockhart.

Slim Framework Skeleton Application with Bootstrap 3 and LESS

Based on Slim-Skeleton by Josh Lockhart., _(*1)

Use this skeleton application to quickly setup and start working on a new Slim Framework application., _(*2)

This application uses the latest Slim and Slim-Views repositories., _(*3)

It also uses Sensio Labs' Twig template library, and Bootstrap 3, _(*4)

Requirements

Composer, _(*5)

node.js, _(*6)

Grunt, _(*7)

Install Composer

If you have not installed Composer, do that now. I prefer to install Composer globally in /usr/local/bin, but you may also install Composer locally in your current working directory. For this tutorial, I assume you have installed Composer locally., _(*8)

http://getcomposer.org/doc/00-intro.md#installation, _(*9)

Install node.js

Visit http://nodejs.org/ and click the big green "Install" button., _(*10)

Install Grunt

npm install -g grunt-cli, _(*11)

Install the Application

After you install Composer, node.js, and Grunt run this command from the directory in which you want to install your new Slim Framework application., _(*12)

php composer.phar create-project jswhetstone/slim-skeleton-bootstrap [my-app-name], _(*13)

Then CD into your newly created application, _(*14)

cd [my-app-name], _(*15)

And run the following commands, _(*16)

npm install, _(*17)

grunt bootstrap, _(*18)

Replace [my-app-name] with the desired directory name for your new application. You'll want to: * Point your virtual host document root to your new application's public/ directory. * Ensure logs/ and templates/cache are web writeable., _(*19)

That's it! Now go build something cool., _(*20)

Provided Grunt commands

grunt watch Watches the less directory for changes, compiles less when any files in the less directory or subdirectory are modified, _(*21)

grunt dist Compiles all less into minified CSS for distribution, _(*22)

grunt bootstrap Copies all files necessary for Bootstrap to function. NOTE: this WILL OVERWRITE all files in less/bootstrap, as well as js/vendor/bootstrap.min.js and js/vendor/jquery.min.js You Should not need to use this command more than once, at the beginning of your project setup, _(*23)

How to Contribute

Pull Requests

1. Fork the jswhetstone/slim-skeleton-bootstrap repository
2. Create a new branch for each feature or improvement
3. Send a pull request from each feature branch to the develop branch

It is very important to separate new features or improvements into separate feature branches, and to send a pull request for each branch. This allows us to review and pull in new features or improvements individually., _(*24)