amber/README.md

Amber

By Nicolas Petton petton.nicolas@gmail.com 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:

• the Helios IDE (https://github.com/amber-smalltalk/helios), as well as
• examples (https://github.com/amber-smalltalk/amber-examples), and
• documentation (https://github.com/amber-smalltalk/amber-documentation)

would need some of your care.

Thank you very much!

(see CONTRIBUTING.md for further details)

Overview

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

• Report issues with the www.amber-lang.net website here: https://github.com/amber-smalltalk/amber-website/issues.
• Report issues with the docs.amber-lang.net website here: https://github.com/amber-smalltalk/documentation/issues.
• Report issues with Amber itself or amber / amberc cli tools here: https://github.com/amber-smalltalk/amber/issues. Issues related to questions during amber init and structure of project created should be reported to https://github.com/amber-smalltalk/grunt-init-amber/issues instead.
• Report issues with the Helios IDE here: https://github.com/amber-smalltalk/helios/issues.

Please refer to CONTRIBUTING.md for further details.

Developing Amber

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

License

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