https://github.com/small-js/smalljs
Smalltalk development in your browser and Node.js
https://github.com/small-js/smalljs
javascript node-js nodejs object-oriented-programming smalltalk smalltalk-language smalltalk-virtual-machine typescript webdevelopment
Last synced: 11 days ago
JSON representation
Smalltalk development in your browser and Node.js
- Host: GitHub
- URL: https://github.com/small-js/smalljs
- Owner: Small-JS
- License: mit
- Created: 2023-08-20T12:31:56.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-02T22:49:15.000Z (30 days ago)
- Last Synced: 2026-02-03T11:45:45.785Z (29 days ago)
- Topics: javascript, node-js, nodejs, object-oriented-programming, smalltalk, smalltalk-language, smalltalk-virtual-machine, typescript, webdevelopment
- Language: Smalltalk
- Homepage:
- Size: 8.59 MB
- Stars: 182
- Watchers: 11
- Forks: 7
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SmallJS README
Official website:
small-js.org
## News - SmallJS 2.0 released! - 21-FEB-2026
[SmallJS 2.0](https://small-js.org/News) now has full support for async, await and promises!\
Almost all async calls classes have been converted form callbacks to promises,\
making code cleaner, more concise and easier to debug.\
Check out [Async.md](./Documentation/Language/Async.md) for usage instructions.\
For other improvements, check out the website.
The SmallJS website now has a [tutorial page](https://small-js.org/Tutorial) for learning SmallJS and Smalltalk.\
The Smalltalk language and core library classes are explained.\
Examples can be done interactively using the online [Playground](https://small-js.org/Playground) .\
(If you have any feedback on the tutorial, please create an issue in the [website repo](https://github.com/Small-JS/Website/issues) ).
The full [class reference](https://small-js.org/Reference) documentation is now also available on the website.
## Introducing SmallJS
SmallJS is a free and open source implementation of the elegant and powerful Smalltalk-80 (ST) language.\
It compiles to JavaScript (JS) that runs in modern browsers or in recent 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).\
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, file mgmt, 5 databases, 5 AI providers.
- Desktop apps: NWjs, Electron, NodeGui.
To get you started quickly, there are several example projects using the above.
## Code example
## Installing
To install SmallJS check out:
[Installing.md](Documentation/Installing/Installing.md)
## Examples
For a first impression of running SmallJS code, see the example projects:
[Examples.md](Examples/Examples.md)
## Playground
To get a feel for Smalltalk and to quickly test out ST expressions,
a playground is accessible though the offical website:
[small-js.org/Playground](https://small-js.org/Playground)
## Documentation
The complete SmallJS documentation, including a tutorial, is located here:
[Documentation.md](Documentation/Documentation.md)
## Contributions
Contributions to SmallJS that are not part of the main system,
but show interesting applications:
[Contributions.md](Contributions/Contributions.md)