Skip to content
Flow Like logo Flow Like Docs

Building from Source

Clone the development branch

Section titled “Clone the development branch”

The repository’s default branch is dev. The alpha branch is used for release snapshots; do not assume a main branch exists.

Terminal window
git clone https://github.com/Rheosoph/flow-like.git
cd flow-like
git checkout dev

Fork the repository first if you plan to contribute.

Install the toolchain

Section titled “Install the toolchain”

Flow-Like uses mise to pin and run the repository toolchain. The root mise.toml currently installs Rust, Bun, Node.js 22, Python 3.12, and uv.

Terminal window
mise trust
mise install
bun install

The desktop build also needs:

  • the Tauri 2 system prerequisites for your operating system;
  • protoc, because Rust build scripts compile the repository’s protobuf definitions;
  • a working C/C++ build toolchain for native dependencies.

Platform-specific native libraries and mobile toolchains have additional requirements. Use the task you intend to run as the final source of truth.

Run the desktop app

Section titled “Run the desktop app”

The top-level task detects the current operating system and architecture:

Terminal window
mise run dev:desktop

Use an explicit task only when you need to override that detection:

Terminal window
mise run dev:desktop:mac:arm
mise run dev:desktop:mac:intel
mise run dev:desktop:win:x64
mise run dev:desktop:win:arm
mise run dev:desktop:linux:x64
mise run dev:desktop:linux:arm

To run the desktop app with the local API and runtime:

Terminal window
mise run dev:desktop:local

Build a release bundle

Section titled “Build a release bundle”
Terminal window
mise run build:desktop

Tauri writes binaries and installers below target/release/; the precise bundle directory and extension depend on the platform.

Other useful tasks

Section titled “Other useful tasks”
Terminal window
mise tasks
mise run dev:web
mise run dev:docs
mise run build:web
mise run build:docs
mise run check
mise run fix

mise.toml is the authoritative task list. Several tasks wrap package-local scripts, so run them from the repository root unless a page explicitly says otherwise.

Linux rendering issues

Section titled “Linux rendering issues”

Tauri uses the system WebKitGTK stack on Linux. If a window fails to render, confirm the Tauri prerequisites for your distribution and check the upstream Tauri issues for your WebKitGTK or graphics-driver combination.