SmallJS README

Official website: small-js.org

Introducing SmallJS

SmallJS is a free and open source implementation of the elegant and powerful Smalltalk-80 (ST) language. It compiles to JavaScript (JS) than runs in modern browsers or in Node.js.

SmallJS is file based, not image based, so you can develop in your favorite IDE. The default setup is for Visual Studio Code, with ST syntax coloring and step debugging! You code separately from the SmallJS base libraries (image) and only the parts you use are imported automatically when running your app.

SmallJS is fully object oriented, so customizable on every level. For usability, ST class and method names are kept mostly equal to their familiar JS counterparts.

JS libraries already encapsulated in ST are:

• Browsers: Document, Window, HTML elements, events, CSS, streams.
• Node.js: HTTP server, Express, 3 databases, files.

To get you started quickly, there are several example projects for development in the browser and a Node.js back-end.<

To get you started quickly, are several example projects
for development in the browser and / or a Node.js back-end.

Code example

Getting started

SmallJS is currently set-up for use with Visual Studio Code, but other IDEs could be added. For the back-end, Node.js is the framework of choice, also using Express. Databases Postgres, MariaDB and MySQL are supported out of the box.

Install prerequisites

To install all the prerequisites, look at:

./Documentation/Prerequisites.md

Now run the bash script ./install.sh. On Windows, the .sh extension should be associated with Git Bash once. Do this by clicking on the file in the explorer and then choose open with Git Bash always.

This script:

• Checks if the prerequisites are present.
• Installs the SmallJS language extension in VSCode.
• Installs npm dependencies for all projects.

Build and test SmallJS projects

Run the bash script: ./build.sh, that:

• Builds the Smalltalk to JS ./Compiler.
• Builds all other ST projects and runs their unit tests.

Notes:

• Browser testing is disabled by default. To enable it, check out:

  ./Documentation/Building.md

• To run the Shop server, you first need to setup a database for the server. Check out:

  ./Examples/Shop/Shop.md

Check if everything builds tests successfully before going to the next step.

Example projects

For a first impression of running SmallJS code, see the example projects:

./Examples/Examples.md

Documentation

The complete documentation is located here:

./Documentation/Documentation.md