pborreli / generator-joli-symfony

Yeoman Generator for Symfony2 projects with sensible defaults and frontend tools.

JoliSymfony - Symfony2

generator-joli-symfony is a Yeoman Generator to scaffold Symfony2 projects with sensible defaults, common bundles and frontend tools.

It will create a new Symfony project, remove Assetic and replace it with either Gulp or Grunt.

Demo

Dependencies

Mandatory dependencies :

• composer
• npm
• yo
• gulp
• grunt

Optional dependencies :

• gem
• compass

What you can choose

• Symfony 2 Standard Edition:
• 2.3
• 2.5
• 2.6
• Grunt:
• grunt-compass
• grunt-coffee
• grunt-sass
• grunt-typescript
• grunt-cssmin
• grunt-uglify
• grunt-copy
• Gulp:
• gulp-ruby-sass
• gulp-copy
• gulp-concat
• Symfony2 Bundle:
• DoctrineFixturesBundle
• DoctrineMigrationsBundle
• DoctrineMongoDBBundle
• Bootstrap 3.3 (SASS)

Default workflow

• Installs Symfony
• Removes Assetic
• Only if using grunt: (load-grunt-tasks)
• Only if using grunt-typescript or grunt-coffeee: (grunt-uglify)
• Only if using grunt-sass or grunt-compass: (grunt-css-min)
• Only if using gulp (gulp-load-plugins)
• Only if using gulp-ruby-sass (gulp-minify-css, gulp-plumber, gulp-rename, gulp-watch)
• Only if using gulp-concat (gulp-uglify)
• Starts the automatic execution of bower, npm and composer after scaffolding has finished.

Assets location

Assets are stored in the app/Resources/ folder :

• app/Resources/scss
• app/Resources/fonts
• app/Resources/...

Bower dependencies (like Boostrap 3.3) are installed in the app/Resources/libs/ folder, thanks to a custom .bowerrc file.

Getting Started

• Install: npm install -g yo
• Install: npm install -g generator-joli-symfony
• Run: yo joli-symfony --force

Contribute

generator-joli-symfony is fork-friendly : you can maintain a custom version, in which you npm install && npm link so that you can still use it with yo joli-symfony, or with the name of your choice.