README.md

Tyrian

An Elm-inspired Scala UI library for Scala 3.

The main documentation site, complete with installation instructions, is available here: tyrian.indigoengine.io/

Thank you, to our sponsors! 💜

Thank you to all our wonderful sponsors, and particularly to dedipresta for their generous support.

If you'd like to help advance our work, we are ever grateful for all forms of contribution, either by volunteering time or financial backing.

Local build instructions

Tyrian is fairly straight forward to build locally, run the following commands from your terminal in the project root:

npm install
sbt clean update compile test +publishLocal

There is also a build.sh script in the root folder, but that also builds the docs and example projects (based on the currently released version).

Nix dev-shell

If you would like to have the environment set up without installing any dependencies globally (think node, yarn, java, etc), you can give the Nix development shells a try.

To use this functionality, you are required to enable flakes.

Usage

$ nix develop

Locally you can run nix develop. However, if you would like to use the same shell in a different repository, you can run the following command instead.

nix develop github:PurpleKingdomGames/tyrian

What do you get?

The default dev shell ships with jdk, mill, sbt and coursier, ensuring all dependencies use the same JDK. It also ships with essential JS tooling in the form of yarn, npm and node.

$ java --version
The program 'java' is not in your PATH. It is provided by several packages.

$ sbt --version
The program 'sbt' is not in your PATH. It is provided by several packages.

$ yarn --version
The program 'yarn' is not in your PATH. It is provided by several packages.

$ npm --version
The program 'npm' is not in your PATH. It is provided by several packages.

$ nix develop

$ java --version
openjdk 17.0.1 2021-10-19
OpenJDK Runtime Environment (build 17.0.1+12-nixos)
OpenJDK 64-Bit Server VM (build 17.0.1+12-nixos, mixed mode, sharing)

$ mill --version
Mill Build Tool version 0.10.0
Java version: 17.0.1, vendor: N/A, runtime: /nix/store/drg31yiw0619r981n0yyv7lnziiyxwww-openjdk-headless-17.0.1+12/lib/openjdk
Default locale: en_US, platform encoding: UTF-8
OS name: "Linux", version: 5.16.10, arch: amd64

$ sbt --version
sbt version in this project: 	1.6.2
sbt script version: 1.6.2

$ cs java-home
/nix/store/drg31yiw0619r981n0yyv7lnziiyxwww-openjdk-headless-17.0.1+12

$ node --version
v16.14.0

$ npm --version
8.3.1

$ yarn --version
1.22.17