Fork me on GitHub

Angular Espresso

Boilerplate for an AngularJS app running on an Express backend, written in CoffeeScript

Download this project as a .zip file Download this project as a tar.gz file

Angular Espresso

Start an app with AngularJS on the client, Express + Node + Socket.IO as your backend, all written in CoffeeScript.

Current version

Current version: 0.2.2

This version includes the following components:

Installation

You need to have installed node and CoffeeScript. Make sure you install CoffeeScript globally. You also need LESS.

Once you have them installed, extract the downloaded file, go to the directory it was extracted to and run either setup.sh or setup.bat, depending on your OS.

Cakefile Usage

Once you install the dependencies, use the Cakefile for performing different actions:

cake build                # Builds app
cake build:module         # Builds the Espresso module
cake build:client         # Builds client scripts
cake clean                # Clean module and client
cake clean:module         # Cleans the Espresso module
cake clean:client         # Cleans the client
cake run                  # Runs the app (you must build first)

The typical usage would be:

cake build
node app # or cake run

Your app will be running on http://localhost:8080

Configuration

There's no configuration for using Angular Espresso, all you need to do is clone/fork the project, install its dependencies with npm and run your node app.

Your .coffee files should be under the "app" folder. The structure is the following:

NOTE: Each directory has a README file with more detail

At the root folder, there are two more folders to consider:

  • Styles: Your LESS styles should go in this directory. Keep in mind that the project has Twitter Bootstrap already included
  • Views: Your views/partial views should go here
  • In the future, I will be adding support for testing. I won't implement file watching until it is stable in node.

    Contribute

    If you want to help, fork/clone/share the project, suggest new features, and/or submit pull requests. Contact me directly at william.r.mora@gmail.com or @wilmor24

    Author

    William Mora - @wilmor24 - williammora.com

    References

    For more on AngularJS: http://angularjs.org

    For more on CoffeeScript: http://coffeescript.org

    For more on Express: http://expressjs.com

    For more on Socket.IO: http://socket.io/

    For more on Jade: http://jade-lang.com

    For more on LESS: http://lesscss.org/