docs.amber-lang.net Open in urlscan Pro
87.197.130.93  Public Scan

Form analysis
0 forms found in the DOM

Text Content

Toggle navigation Amber docs
 * ← Back to amber-lang.net


AMBER DOCS V0.12.4
GUIDES & API REFERENCE

 * Quick start guide
   
 * Overview
    * Installing Amber
    * Loading Amber
    * Creating Packages
    * FAQ
    * JavaScript ecosystem glossary

 * How-to's
    * How to create, publish and use Amber libraries


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.

Next section →

Copyright © 2014 Nicolas Petton and Amber contributors. The content of this
website in licensed under CC-BY-NC 3.0.