generator-symfonic-assets

Generator for setting up asset generation for Symfony PHP projects.

Installation

First install node.js, Gulp and Bower if you haven't already. Then install Yeoman and generator-symfonic-assets using npm.

npm install -g yo
npm install -g generator-symfonic-assets

Then change into a fresh Symfony PHP project folder:

yo symfonic-assets

ATTENTION

This generator is made for the sole purpose of generating front end assets for Symfony PHP framework projects, so it's mandatory to have a fresh Symfony project ready

After installing all dependencies please run gulp jslibs first to concatenate and compress all the JS libraries. Feel free to run this command again any time you add a new library (either through Bower or manually).

Available Gulp tasks

Default Task
This is run when you enter gulp on the command line. It starts Symfony's development server, dumps all assets from other bundles and takes care about starting up BrowserSync and compiling all the assets.

Images Task
Running gulp images optimizes all the images from the web-src/images directory and copies them into the web/images folder.

Sass-Lint Task
gulp sass-lint lints all the given Sass files, configured through paths.scss.lint.

JSLibs Task
gulp jslibs concatenates and minifies all the given JS libraries - configured through paths.js.libs - and puts them into the target directory. This must be run after Yeoman initially and every time a JS library (external) is added.

Getting To Know Yeoman

• Yeoman has a heart of gold.
• Yeoman is a person with feelings and opinions, but is very easy to work with.
• Yeoman can be too opinionated at times but is easily convinced not to be.
• Feel free to learn more about Yeoman.

License

MIT © Nils Butenschön