Plugins

Rekindle provides client templates for GPUI, egui/eframe, and Slint. A plugin selects the Rust dependencies, platform bootstrap code, browser host, Web shell CSS, and graphics backend expected by the generated client. The installer makes that shell the Phoenix root layout's primary surface, so Web and desktop start with the same shared Rust UI.

GPUI

mix igniter.install rekindle --plugin gpui --targets web,desktop

GPUI uses its Web platform for the browser target and its native platform for desktop. The browser target requires WebGPU and creates its own canvas. Rekindle installs the full-page canvas rules used by GPUI Web's hello example.

egui/eframe

mix igniter.install rekindle --plugin egui --targets web,desktop

The generated Web entry mounts eframe into a canvas and uses WebGL2. The desktop entry uses eframe's native runtime. The shared TemplateApp lives in client/src/app.rs, following the official eframe template layout. The generated Web shell uses the official template's full-page canvas layout.

Slint

mix igniter.install rekindle --plugin slint --targets web,desktop

The generated Web entry mounts Slint into a canvas and uses WebGL2. The desktop entry uses Slint's native runtime. The generated build.rs compiles client/ui/app-window.slint, while client/src/lib.rs connects the component's callbacks for both targets. The generated Web shell gives the shared Slint window the complete browser surface.

Shared UI code

Every plugin keeps one shared application implementation for Web and desktop. GPUI uses client/src/lib.rs; eframe follows its official client/src/app.rs plus client/src/lib.rs layout; Slint keeps its UI in client/ui/app-window.slint with shared Rust bindings in client/src/lib.rs. The web and desktop binaries contain platform startup code only. Target-specific behavior can be selected with the generated Cargo features.

Re-running the installer preserves the generated Cargo client. The installer does not overwrite an unmanaged client/Cargo.toml.

External plugins

A plugin implements Rekindle.Plugin and returns a declarative Rekindle.Plugin.Spec. Its Rust and UI sources remain ordinary files in the plugin package's OTP priv directory:

defmodule MyUi.RekindlePlugin do
  @behaviour Rekindle.Plugin

  @impl true
  def name, do: "my-ui"

  @impl true
  def spec(_options) do
    %Rekindle.Plugin.Spec{
      name: name(),
      dependency: "my-ui",
      source: {:my_ui_rekindle, "templates/client"},
      files: %{"src/lib.rs" => "src/lib.rs"},
      entries: %{
        web: "src/bin/web.rs",
        desktop: "src/bin/desktop.rs"
      },
      cargo: %Rekindle.Plugin.Cargo{
        dependencies: [
          %Rekindle.Plugin.Cargo.Dependency{name: "my-ui", version: "1.0"}
        ]
      },
      toolchain: "stable",
      web: %Rekindle.Plugin.Spec.Web{
        graphics: :webgl2,
        host: "",
        style: ""
      }
    }
  end
end

The plugin package can expose its own Igniter task and delegate installation:

Rekindle.Install.run(igniter,
  plugin: MyUi.RekindlePlugin,
  targets: [:web, :desktop]
)

Plugins declare requirements only. Cargo execution, file watching, process management, Phoenix delivery, and artifact publication remain owned by Rekindle.