Tyrian
An Elm-inspired Scala UI library for Scala 3.
The main documentation site, complete with installation instructions, is available here: tyrian.indigoengine.io/
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