HTML5/JS Tutorial HooDyooDoo HTML5/JS Tutorial Part I

View the Project on GitHub FatFractal/hoodyoodoo


The very first thing you want to do, no two ways about it, is install the FatFractal Engine on your development machine. Installing the local runtime and Command Line Interface (CLI) tools is really simple. All you need to do is download the distribution, unzip it, copy the contents to the directory you want and the add the location to your path. It only takes a few minutes and does not invade your machine with a lot of unnecessary stuff.

Installing the Local Runtime and CLI tools

The FatFractal runtime download is required to deploy apps and to run a local instance of the FatFractal engine. After downloading, getting started is a snap:

  1. Download the ZIP File from here and unzip to a location of your choice on your development machine.
  2. Add the FatFractal_Runtime/bin directory to your path. This directory contains the ffef / ffef.bat command, which is used to scaffold and deploy apps and the ff-service / ff-service.bat command, which is used to run your local instance of the FatFractal engine.
  3. Start the local engine, just cd into FatFractal_Runtime and run the command bin/ff-service cl.
> cd <FatFractal_Runtime>;
> bin/ff-service cl

In the FatFractal_Runtime/conf directory you will find a file called which tells the engine the ports on which to listen (defaults are 8080 for http and 8443 for https), and how frequently to scan for new deployments (default is every 5 seconds)

The Hoodyoodoo Tutorial's sample app is written using the API on the cloud, which means that it really works when you download it. To create and use your own API, you need to follow the getting started sections below and change the baseUrl of the FatFractal instance to use yours. You can choose to deploy your API either locally or in the cloud; it really is up to you. If you feel like keeping it away from the InterWebs, you may do that as well. You will want to jump for joy, upon learning that the FatFractal Engine is identical whether on your local setup or in the cloud. It's not a simulator. It is the whole schlemiel. If you do choose to work locally and deploy to the cloud later, it will work just as you would expect.

If you download the sample files, you will notice you can run the application immediately using the API that we have deployed. To create your own instance of the hoodyoodoo API, you need to scaffold your application and configure the API.

Setting up your own hoodyoodoo API

First, create a directory for your project called hoodyoodoo.

> cd $HOME;
> cd ffapps
> mkdir hoodyoodoo
> cd hoodyoodoo

Then, scaffold the application by doing the following using your subdomain:

> <install directory>/fatfractal/runtime/ffnsbin/ffef newapp hoodyoodoo <your subdomain>

Note: The subdomain refers to one you've registered in the FatFractal Console or during the installation process (e.g. 'acme' in

This will create all the information your API needs to work with your application.

Running in the Cloud

If you haven't already, go to the Console and add an application called hoodyoodoo to <your subdomain>.

To deploy the now-scaffolded hoodyoodoo API to the NoServer Public Cloud via the command line, you use the command ffef deployFFFabric:

> <install directory>/fatfractal/runtime/ffnsbin/ffef deployFFFabric

In a few seconds, your application will be available at http://<your subdomain>

For more information, see Getting Started.

Running locally

Assuming that the FatFractal Engine is running, you can deploy to your development machine via the command line using ffef deploylocal:

> <install directory>/fatfractal/runtime/ffnsbin/ffef deploylocal

Your API will be available at http://localhost:8080/hoodyoodoo

NEXT: Create Directory Structure