Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

Build Status NPM package

HSLuv - Human-friendly HSL

Explanation, demo, ports etc.

The reference implementation is written in Haxe.

Build system

HSLuv uses Nix package manager. If you want to build without Nix, see default.nix for dependencies and command line instructions.

Linux, Windows 10 (WSL), macOS 10.14 and earlier:

  • Install Nix
  • Use: ./ <COMMAND> <TARGET>

Linux, macOS:

  • Install Docker

The necessary mathematical equations are solved in Maxima. See /math directory for the equations and run the following to verify the solutions:

./ build maximaOutput

To run full test suite:

./ build test

To build JavaScript distributions (Node.js and browser):

./ build nodePackageDist
./ build browserDist

To build website:

./ build website

To build website and start localhost server:

./ run server


The snapshot file is stored for regression testing. If a backwards-incompatible change is made, a new snapshot file can be generated as follows:

./ build snapshotJson

The format of the file is as follows:

  "#000000": {
    rgb: [ 0, 0, 0 ],
    xyz: [ 0, 0, 0 ],
    luv: [ 0, 0, 0 ],
    lch: [ 0, 0, 0 ],
    hsluv: [ 0, 0, 0 ],
    hpluv: [ 0, 0, 0 ]


For publishing packages and website you will need access to our shared credentials.

./ run publishPypi
./ run publishNpmJs
./ run publishNpmSass
./ run publishLua
./ run publishWebsite
./ run publishRuby
./ run publishNuget


Following semantic versioning, the major version must be incremented whenever the color math changes. These changes can be tested for with snapshot files.

You can’t perform that action at this time.