generator-marionette

Yeoman generator for Express, Marionette and Backbone with AMD

generator-marionette

Yeoman generator for Express, Marionette and Backbone with AMD

  • Server:
    • Node: http://nodejs.org/
    • Express: http://expressjs.com/
    • Socket IO: http://socket.io/
    • Faye: http://faye.jcoglan.com/
  • DB: Mongo: http://www.mongodb.org/
  • ODM: Mongoose: http://mongoosejs.com
  • Client:
    • Backbone: http://backbonejs.org/
    • Marionette: https://github.com/marionettejs/backbone.marionette
    • jQuery: http://jquery.com/
    • Require: http://requirejs.org/
    • Handlebars:
      • http://handlebarsjs.com/
      • https://github.com/SlexAxton/require-handlebars-plugin
      • https://github.com/asciidisco/Backbone.Marionette.Handlebars
    • SASS-Bootstrap:
      • http://twitter.github.io/bootstrap
      • https://github.com/thomas-mcdonald/bootstrap-sass
  • Tooling:
    • Yeoman: http://yeoman.io/
    • Bower:
    • Grunt
  • app/ --> client side files

    • /bower_components --> bower installs

    • /images

    • /scripts

      • /vendor --> 3rd party scripts
      • /models
      • /collections
      • /controllers
      • /routers
      • /regions
      • /views
        • /item
        • /collection
        • /composite
        • /layout
      • init.js --> require configuration
      • main.js --> application starting point
      • application.js --> application file
    • /styles --> scss files

    • /templates --> handlebar templates

  • server/ --> node server files

  • test/ --> unittesting

First make sure you have MongoDB, Node, Npm, Yeoman, Bower and Grunt installed.

Install mongoDB with: brew install mongodb or visit http://www.mongodb.org/

Visit nodejs.org to install node and NPM

To install Yeoman, Bower and Grunt run: npm install -g yo grunt-cli bower

Install mocha generator: npm -g install generator-mocha

You can install this generator by two ways, clonning repo and linking or install by npm. To install clonnig repo run:

$ git clone https://github.com/mrichard/generator-marionette.git
$ generator-marionette
$ npm link

Or to install by npm run:

$ npm install git://github.com/mrichard/generator-marionette.git

To bootstrap a new project simply run

$ yo marionette

You have options to include a few Node packages

To start the app run

$ grunt expressserver

You can generate routers too with

$ yo marionette:router router-name

To add a Backbone model to the project use the model generator like this

$ yo marionette:model model-name

Or to inherit from an existing model

$ yo marionette:model model-name --inherit model-name

To add a Backbone collection to the project use collection generator

$ yo marionette:collection collection-name

You can link the collection with an existent model

$ yo marionette:collection collection-name model-name

Or may be you want to create both, model and collection on one step

$ yo marionette:collection collection-name --model model-name --create-all

Or you may want to inherit from another collection

$ yo marionette:collection collection-name --model model-name --inherit collection-name --create-all

Backbone works with view definitions, to create one use this command

$ yo marionette:view view-name

Create a Marionette ItemView

$ yo marionette:itemview view-name --inherit view-name

You can link to an existent template at location templates/[template-location]

$ yo marionette:itemview view-name --inherit view-name

Or maybe you want to create both, itemView and template on one step

$ yo marionette:itemview view-name --inherit view-name --create-all

Create a Marionette CollectionView

$ yo marionette:collectionview view-name

You can link to an existant itemview

$ yo marionette:collectionview view-name --itemview itemview-name --inherit view-name

Or maybe you want to create both, itemview and collectionview. In that case you may want to create an itemview template as well

$ yo  marionette:collectionview view-name --itemview itemview-name --inherit view-name --create-all

Create a Marionette CompositeView

$ yo marionette:compositeview view-name --itemview itemview-name --inherit view-name

Or maybe you want to create all, itemview and compositeview and both templates. In that case you may want to create an itemview template as well

$ yo marionette:compositeview view-name --itemview itemview-name --inherit view-name --create-all

Create a Marionette Region

$ yo marionette:region region-name --inherit region-name

Create a Marionette Layout

$ yo marionette:layout layout-name --inherit layout-name

You can link to an existent template at location templates/[template-location]

$ yo marionette:layout layout-name --inherit layout-name

Or maybe you want to create both, Layout and template on one step

$ yo marionette:layout layout-name --inherit layout-name --create-all

Create a Marionette Controller

$ yo marionette:controller controller-name --inherit controller-name

Create a handle bars tmpl

$ yo marionette:tmpl tmpl-name --tmplLocation tmpl-location

Default test framework for this generator is mocha

  • auto generate failing unit tests
  • install Bower mocha, chai etc