README.md

##Introduction

Effortlessly generate Spine, CoffeeScript and Hem applications. Spine.App gives your applications structure, CommonJS modules, a development server and more.

##Usage

First step is to install the npm package. If you don't already have npm or NodeJS you'll need to install them first.

$ npm install -g spine.app

Then we can generate the initial application structure like this:

$ spine app my_app

Now we've produced a directory structure looking like:

my_app
my_app/app
my_app/app/controllers
my_app/app/models
my_app/css/index.styl
my_app/lib
my_app/lib/jquery.js
my_app/lib/spine.js
my_app/public
my_app/public/index.html
my_app/public/css
my_app/public/images
my_app/index.js

First let's navigate to our application, and install it's npm dependencies:

$ cd my_app
$ npm install .

These will be exported locally in the ./npm_modules folder. Now, let's install Hem, which will be in charge or bundling our application.

$ npm install -g hem

And to serve our application up:

$ hem server

This will boot up an server on port 9294. You can now start generating Spine controllers and models:

$ spine controller users
    app/controllers/users.coffee

$ spine model user
  app/models/user.coffee

Any application specific code should go in the app folder. Otherwise, generic code, should go in the lib folder.

Any CoffeeScript or Stylus files inside the application will be automatically compiled when requested, you don't need to worry about compiling them manually.

Stitch bundles up all your JavaScript files, enclosing them in a CommonJS wrapper. This means that scripts in the app folder need to be CommonJS compliant (basically exactly like normal Node scripts). In other words, to use a module you'll need to require() it, and you'll need to explicitly export any global variables.

Guide = require("controllers/guide")

class App extends Spine.Controller
  elements:
    "#item": "item"
  
  init ->
    @guide = new Guide(el: @item)
    
# Explicitly export it
module.exports = App

Inside your HTML files, you need only require application.js and every module will be wrapped up and ready to be loaded. As you can see, the generated index.html kicks things off by instantiating app/app.coffee when the page loads.

var exports = this;
jQuery(function(){
  var App = require("app");
  exports.App = new App({el: $("#body")});      
});