jswhetstone / slim-skeleton-bootstrap
A Slim Framework skeleton application with Bootstrap3; based on Slim-Skeleton by Josh Lockhart.
Installs: 307
Dependents: 0
Suggesters: 0
Security: 0
Stars: 19
Watchers: 4
Forks: 452
Language:HTML
Requires
- php: >=5.3.0
- components/bootstrap: 3.*
- components/jquery: 1.*
- jswhetstone/twig-extension: dev-master
- monolog/monolog: 1.*
- slim/slim: 2.*
- slim/views: 0.*
- twig/twig: 1.*
This package is not auto-updated.
Last update: 2023-01-07 07:18:54 UTC
README
Based on Slim-Skeleton by Josh Lockhart.
Use this skeleton application to quickly setup and start working on a new Slim Framework application.
This application uses the latest Slim and Slim-Views repositories.
It also uses Sensio Labs' Twig template library, and Bootstrap 3
Requirements
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.
http://getcomposer.org/doc/00-intro.md#installation
Install node.js
Visit http://nodejs.org/ and click the big green "Install" button.
Install Grunt
npm install -g grunt-cli
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.
php composer.phar create-project jswhetstone/slim-skeleton-bootstrap [my-app-name]
Then CD into your newly created application
cd [my-app-name]
And run the following commands
npm install
grunt bootstrap
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/
andtemplates/cache
are web writeable.
That's it! Now go build something cool.
Provided Grunt commands
grunt watch
Watches the less directory for changes, compiles less when any files in the less directory or subdirectory are modified
grunt dist
Compiles all less into minified CSS for distribution
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
How to Contribute
Pull Requests
- Fork the jswhetstone/slim-skeleton-bootstrap repository
- Create a new branch for each feature or improvement
- 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.