shiroa

There are multiple ways to install the shiroa CLI tool. Choose any one of the methods below that best suit your needs.

Executable binaries are available for download on the GitHub Releases page. Download the binary for your platform (Windows, macOS, or Linux) and extract the archive. The archive contains an shiroa executable which you can run to build your books.

To make it easier to run, put the path to the binary into your PATH.

To build the shiroa executable from source, you will first need to install Yarn, Rust, and Cargo. Follow the instructions on the Yarn installation page and Rust installation page. shiroa currently requires at least Rust version 1.75.

To build with precompiled artifacts, run the following commands:

cargo install --git https://github.com/Myriad-Dreamin/shiroa --locked shiroa

cargo install --git https://github.com/Myriad-Dreamin/shiroa --locked shiroa

To build from source, run the following commands (note: it depends on yarn to build frontend):

git clone https://github.com/Myriad-Dreamin/shiroa.git

git submodule update --recursive --init

cargo run --bin shiroa-build

# optional: install it globally

cargo install --path ./cli

git clone https://github.com/Myriad-Dreamin/shiroa.git

git submodule update --recursive --init

cargo run --bin shiroa-build

# optional: install it globally

cargo install --path ./cli

With global installation, to uninstall, run the command cargo uninstall shiroa.

Again, make sure to add the Cargo bin directory to your PATH.