Getting Started

Copy Markdown View Source

This guide covers installation into an existing Phoenix application. For a new application, use the mix igniter.new command shown in the README.

Desktop builds use the host target reported by rustc -vV.

Add Rekindle to an existing Phoenix application

Add Igniter to the application's development dependencies:

def deps do
  [
    {:igniter, "~> 0.8", only: [:dev, :test]}
  ]
end

Fetch the dependency, then install Rekindle:

mix deps.get
mix igniter.install rekindle --integration gpui --targets web,desktop

Valid integrations are gpui, egui, and slint. Valid target selections are web, desktop, and web,desktop. When the flags are omitted for a new client, Rekindle selects GPUI and enables both targets. The Web target is wasm32-unknown-unknown; desktop builds use the Rust host target.

Run the installer again with the current integration and a superset of the configured targets to add a target later. Existing Rust UI source files are preserved. The installer does not remove targets or switch integrations.

The installer adds Rekindle as an application dependency, creates the Rust client, configures the Phoenix development runtime, and adds Web builds to the standard assets.build and assets.deploy aliases.

Existing client directory

Rekindle does not overwrite an existing client/Cargo.toml. Move or rename an unmanaged client/ directory before installation.

Next steps

Read How Rekindle Works for the generated client layout, then continue with Configuration or Development.