A collection of JS modules to meet basic needs for web clients.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1.7 KiB


UnitJS is a tiny Javascript framework to write web applications. It provides four essential modules to deal with asynchronous functions (technically, it's a monad obtained by currifying the CPS functions of Javascript like setTimeout), value caching, DOM manipulation and basic functional needs like composition or object projections.


With SJW

UnitJS comes as a SJW package. You can install it by copying the src/ directory of this repository to your package database by issuing the following command from the current directory :

$ cp -r src/ ~/.sjw/unitJS

Then, using unitJS in your projects is as simple as writing :

import * as Async from UnitJS.Async;

in any module if you want to use the Async module for instance and compile your code using the --include option of sjw with package unitJS :

$ sjw -I unitJS your/code/src -o your/code/main.js

Note that all modules have their path prefixed by a common UnitJS component and that SJW will only include the modules actually used in your code, not all of UnitJS.

As a standalone JS script

If you don't want to or can't use SJW, it's still possible to use UnitJS by generating a single script that can then be loaded from your web page like this :

<script src="/path/to/unit.js"></script>

The file unit.js can be easily generated with make, which actually just calls the unit.js.tpl script. Note that you can still generate custom «partial» versions of unit.js if you don't use all of it by overriding the SRC variable of the Makefile like so :

make SRC="src/UnitJS/Dom.js src/UnitJS/Cache.js"

or by manually calling ./unit.js.tpl with the files you want, like the Makefile does.