Amber docs v0.12.4
Guides & API reference

Installing Amber

1. The npm package

The npm package contains two command-line tools: amber, and amberc (the command-line compiler).

The amber tool includes a server to run on localhost and makes it easier to save packages to be committed on disk. It is a very convenient way to get started.

npm is a package manager for nodejs, a JavaScript runtime used to run JavaScript code outside of the web browser.

nodejs and npm can either be downloaded from the website, or installed using Operating System specific package managers.

Installing nodejs on MacOS X and Windows

The easiest way to install nodejs on MacOS X and Windows is to download the installer from the downloaded page.

For MacOS X users, nodejs can also be installed with homebrew:

brew install nodejs

When installed via homebrew, npm may have problems updating, running npm -gf update instead of traditional npm -g update solves the issue.

Installing nodejs on other operating system

See node.js instructions for installing node and npm using respective package managers.

Installing the node amber package

Once nodejs and npm are installed, evaluate:

npm install -g amber-cli

2. The bower component

The following section explains how to manually setup Amber using Bower. The amber init command provided by the npm package automates it. Unless you want to (a) understand how it works or (b) setup Amber differently, you can refer to the getting started page.

The npm package doesn’t provide the JavaScript files required to load Amber in a page. This is instead provided by the bower package.

Bower is a package manager for the web. It makes it easy to manage dependencies in your application including Amber. Unlike npm, Bower components are meant to be used inside the web browser.

If not already present, Bower is installed using npm: npm install -g bower

In the root directory of the project, Amber bower component can be installed either by

bower install amber --save

or by adding a bower.json file like the following:

{
    "name": "example-project",
    "dependencies": {
        "amber": "~0.12.4"
    }
}

and evaluating

bower install

In both cases, Amber will be installed in a directory named bower_components.

We will see in the next section how to setup a project using bower.