Fuel Throttle is an application scaffolding / acceleration project focused on helping developers do what they do best...WRITE APP CODE!
The primary use case for Fuel Throttle (Node) is centered around the following tech:
- ExactTarget's HubApps (IMH, Interactive Marketing Hub)
- Using the Stackato (Fuel Platform's PaaS) infrastructure
- Require.js (Well performing dependency management and code optimization tool)
This tool will reduce your need to write boilerplate code.
The overriding design goal for Fuel Throttle is to reduce the development cycles required to get application code into the Fuel Platform ecosystem.
The secondary goal of Fuel Throttle is to reduce the cost of admission for development of apps by resolving common issues.
Fuel Throttle (Node) integrates the following technologies for you:
- Code@ - ExactTarget's Developer Community
- Fuel API Family - ExactTarget's RESTful based API ecosystem
- App Center - ExactTarget's Application Management Interface
- Fuel UX - The Fuel Platform control library built on Twitter's Bootstrap
- Stackato - ActiveState's PaaS implemented at ExactTarget
- Twitter Bootstrap - great UI boilerplate for modern web apps
- node.js - evented I/O for the backend
- Express - fast node.js network app framework @tjholowaychuk
- Backbone.js - Loosly defined client-side MVC structuring library
- jQuery - duh
Fuel Throttle has the following dependencies on your local system in order to operate properly:
- (recommended) Git: http://git-scm.com/downloads
- Install node.js: http://nodejs.org/download/
- (recommended) Node Version Manager: https://github.com/creationix/nvm
- Install grunt: http://gruntjs.com/
- [optional]Install grunt-init: http://gruntjs.com/project-scaffolding
- MongoDB: http://docs.mongodb.org/manual/installation/
- PhantomJS: https://github.com/ExactTarget/fuelux/wiki/Installing-grunt-and-PhantomJS
- (recommended) Stackato Micro Cloud: http://www.activestate.com/stackato/download_vm
- Install Stackato Client: http://www.activestate.com/stackato/download_client
- System Accounts:
- QA Stackato account, please email firstname.lastname@example.org
- (recommended) New Relic account [http://newrelic.com/] for application monitoring NewRelic
- (recommended if public repo on Github.com) Travis CI account https://travis-ci.org/
HOW TO USE
npm install -g grunt grunt-cli grunt-init
git clone email@example.com:ExactTarget/fuel-throttle-node.git ~/.grunt-init/et-hub-app
- Test that the template is available:
grunt-init --help(look in the templates section you should see et-hub-app)
mkdir <path/to/your/apps/><yourNewAppName>(directory name will be the name of the new app by default, but can be changed)
git init// initialize git in the directory
- Answer questions, and start coding your app! (or follow directions for running your app in: http://github.et.local/Platform/Fuel-Throttle-Node)
Optional Quick Start Instructions
npm install--> Install all dependencies
grunt build--> Package the code for PaaS deployment (or running locally in optimized mode)
node <server/app.js>-- Start your app
Run the app in non-optimized (non-minified/uglified) mode
$ node app
To run the app locally in optimized mode, use an editor and open: /config/default.js file
change "endpoints.uiBaseDir" value to "optimized"
write, close /config.default.js
$ node app
Running on Stackato Micro Cloud
- Make sure you've installed the Stackato Micro Cloud and the Stackato client
- Start the Stackato Micro Cloud VM
- Make sure you're targeting the correct Stackato environment (our Micro Cloud URL)
- stackato login
- stackato push (from within the app's directory)
- Answer prompts from Stackato where applicable
- Visit your app's new URL in a browser
Tests are ran automatically when using grunt-build, grunt-package commands. To test ONLY, use grunt test at the prompt.
While grunt can run the included unit tests via PhantomJS, this isn't a substitute for the real thing. Please be sure to test the tests/*.html unit test file(s) in real browsers as well.
More about Installing grunt and PhantomJS
Fuel Throttle goals will be outlined in the project's milestones on Github.
There are several known issues as this is an organic project, please check the issue list for a complete current state of the project.
Contributing to Fuel Throttle
Contributions are welcomed, to contribute to Fuel Throttle:
- Before writing code, we suggest you search for issues or create a new one to confirm where your contribution fits into our roadmap.
- Fork the Fuel Throttle repo GitHub help
- Make your changes, being sure to add unit tests for new or changed functionality
grunt packageto lint, test, and package up the library
- Update your fork with the latest code from Fuel Throttle, merging as necessary
- Commit your changes (using
git commit --amendto the original as you progress)
- Push to your GitHub repo, using --force if you have rebased
- Submit a pull request GitHub help
Free Software, Currently only recommended for internal ExactTarget usage!
Author(s): _ Benjamin Dean
Reference and Contributor(s):