Run

The balihoo-creative utility has a built in web server that imitates a production local website server. It even watches your assets and templates to automatically refresh as you make updates.

Running

You'll run the utility at the top level of your local site project. 

cd existingProject
balihoo-creative

If you want a lot more details about what's going on under the hood you can run it in verbose mode.

balihoo-creative -v

After you run it your browser should pop open to this tutorial, now hosted on your own machine. The app will continue to run until you kill it with CTRL-c

Directory Structure

The first thing you'll notice when you run balihoo-creative in is that it creates a bunch of files and directories. You should see something like the following. We'll cover each of these files and in a minute. If any of these top level files or directories does not already exist in your project then the app will create it for you and populate it with example files from this tuturoial. 

{{> directory}}

The Console

You have noticed by now that running the app causes the browser to pop open a new tab with a live preview of the local site. If you look carefully, there is a panel at the top of the browser window containing a url bar and a pull-down box.

{{^textonly}}

This is the console.

{{/textonly}}

The console runs your site in an iframe and communicates with the app to determine when it should refresh your site. You can directly browse to different pages by updating the URL in the navigation box, but generally you should just use the links within your site itself. You will notice that the nav box updates with the current URL when you click around to different links in your site. We'll discuss the pull-down box in a minute.