--- name: install-update url: /install ---

Install and Update

Ready to make sweet web apps? Setup is straight forward and if you haven't used Sass before, once you do, you'll never look back.


Quick Install: Using our CLI

Just like with Foundation for Sites, we wrote an awesome command-line tool to make settting up new Foundation for Apps projects a breeze. The CLI downloads a template project that uses Foundation, Angular, Sass, and Gulp. If you'd rather install our components into your own stack, see our advanced instructions below.

Node.js

Node allows you to run JavaScript outside of a web browser, and it powers several tools we use in the development process, like Bower and Gulp.

Download Node.js →

Git

Git is a version control system used to collaboratively develop software. The package manager Bower uses Git to download software onto your computer.

Download Git →

Ruby

Ruby powers Sass, the CSS preprocessor Foundation for Apps is written in. To compile the CSS that powers our components, you'll need Ruby and Sass on your machine.


Install Instructions

With the above software installed, open up your command line. Start by installing the Foundation CLI, Bower, and Gulp using Node:

npm install -g foundation-cli bower gulp

If you don't have Bundler installed, you'll want to install that as well:

gem install bundler

You now have access to the `foundation-apps` command on your system! You'll use this to setup and update new projects. To build a new project, use this command:

foundation-apps new myApp

Change `myApp` to the name you'd like the folder to be. This will download our template stack, and install Foundation for Apps, Angular, and Gulp. The whole process takes between 30 seconds and a minute, depending on your Internet connection.

Once the installer is done, navigate into the directory using `cd`:

cd myApp

Now you can build the app and begin working on it.

foundation-apps start This will assemble all of the pieces—the Angular components, Sass, and views—into a new folder called `build`, which is your final app. The build process will also setup a temporary server that points to the finished app. You can get to the server by going to this URL in your browser: http://localhost:8080

Manual Install

Foundation for Apps can be installed manually through Bower

bower install foundation-apps

The package includes these folders: