Amber is an implementation of the Smalltalk language that runs on top of the JavaScript runtime.

Herbert Vojčík 36bdd94ae2 Boolean methods cleaned, = uses valueOf 5 years ago
external e04bda2c84 devkit: More permissive wording om missing dep 5 years ago
internal 270364cf67 load Benchfib in amber dev environment 5 years ago
src 36bdd94ae2 Boolean methods cleaned, = uses valueOf 5 years ago
support 404a9fc37e Revert "Revert "boot.js: Cross-frame version of st.assert"" 5 years ago
.gitignore 95e0c1f268 The config.js file is in .gitignore 5 years ago
.npmignore c641d58a97 .npmignore and bower ignore on par. Fix #1120. 5 years ago
.travis.yml 32cd3ec3c8 travis: test npm-publish latest and bleedingedge versions 6 years ago
API-CHANGES.txt 13183ebb7d API-CHANGES.txt: isNil/ifNil move 5 years ago
CHANGELOG 24242d321e Update CHANGELOG 5 years ago e6af1ba85a Updating "how to clone" w/ attic 5 years ago
Gruntfile.js 3478c51589 amber-attic in its own repo 5 years ago
LICENSE 4a3475c8b8 Updates the license 6 years ago a7041ed9d8 Install instructions for 0.14.2 including compat 5 years ago
bower.json 2d2285a55c Working on 0.15.0 5 years ago
favicon.ico 8b43eb58f1 Add a favicon 7 years ago
jquery.amd.json e9def3953e jQuery used in nonminified version 6 years ago
local.amd.json ee271db23f no one uses amber_css anymore 5 years ago
package.json 2d2285a55c Working on 0.15.0 5 years ago

Amber Gitter Travis CI Status devDependency status

By Nicolas Petton and Amber contributors

Amber is an implementation of the Smalltalk language that runs on top of the JavaScript runtime. It is designed to make client-side development faster and easier.

\o/ Call for contributors! \o/

The core project of Amber has enough resources, but:

would need some of your care.

Thank you very much!

(see for further details)


Amber is written in itself, including the parser and compiler. Amber compiles into efficient JavaScript, mapping one-to-one with the equivalent JavaScript. There is no interpretation at runtime.

Some highlights:

  • Amber features an IDE with a Class browser, Workspace, Transcript, a ReferencesBrowser supporting senders/implementors and class references, basic Inspector and even a beginning of a Debugger and a unit TestRunner.
  • Pharo Smalltalk is considered as the reference implementation.
  • Amber includes a canvas to generate HTML, like Seaside
  • Amber can use Javascript libraries and the current IDE is built on jQuery
  • You can inline Javascript code and there are many ways to interact between Amber and Javascript

Getting Amber

Amber is shipped as a cli tool to create new projects and assist with development tasks in a npm package amber-cli and as a library to be used by projects in a bower package amber.

Do this [1] to create an Amber project of your own and start working in it:

# Install the CLI tool `amber-cli` and supporting tools
npm install -g amber-cli bower grunt-cli

# Initialize your project (directory must be empty)
cd /path/to/myproject
amber init

# (optional) Install backward compatibility
bower install amber-compat-es5 --save   # be loadable in older browsers
bower install amber-compat-ie8 --save   # additional tweaks to load in IE8

# Serve amber on localhost:4000
amber serve

The Getting started page shows more details on ways to obtain Amber and start a project.

[1] For installation to work, you need to install node, npm and git (in Windows, use Git for Windows and select "Run Git from Windows Command Prompt" and "Checkout Windows-style, commit Unix-style" installation options).

Reporting issues

Please refer to for further details.

Developing Amber

Please refer to for further details. It explains the Amber development setup and how to contribute.


Amber is released under the MIT license. All contributions made for inclusion are considered to be under MIT.

More infos

More on the project page