lustre_tauri

Use Tauri invoke commands from Lustre via its effect interface.

The API and details are heavily based on lustre_http.

This library currently only supports invoke commands, not events

Requirements

This requires that you have the @tauri-apps/api package installed.

Example

import lustre
import lustre/attribute
import lustre/effect.{type Effect}
import lustre/element.{type Element}
import lustre/element/html
import lustre/event
import lustre_tauri.{type TauriError}

pub fn main() {
    let app = lustre.application(init, update, view)
}

type Model {
    Model(name: String, message: String)
}

fn init(_) -> #(Model, Effect(Msg)) {
    #(Model(name: "", message: ""), effect.none())
}

pub opaque type Msg {
    UpdateName(String)
    GreetUser(Result(String, TauriError))
    Greet
}

fn update(model: Model, msg: Msg) -> #(Model, Effect(Msg)) {
  case msg {
    UpdateName(name) -> #(Model(..model, name: name), effect.none())
    GreetUser(Ok(message)) -> #(
      Model(..model, message: message),
      effect.none(),
    )
    GreetUser(Error(_)) -> #(model, effect.none())
    Greet -> #(model, greet(model.name))
  }
}

fn greet(name: String) -> Effect(Msg) {
    lustre_tauri.invoke(
        "greet",
        [],
        lustre_tauri.expect_text(GreetUser)
    )
}

fn view(model: Model) -> Element(Msg) {
  html.div([], [
    html.h1([], [element.text(model.message)]),
    html.input([
      attribute.type_("text"),
      attribute.name("greet_name"),
      event.on_input(UpdateName),
    ]),
    html.button([event.on_click(Greet)], [element.text("Send your name!")]),
  ])
}

Installation

Like Lustre, this is published on Hex. You can add it to your Gleam project via

gleam add lustre_tauri

You will also need to install the @tauri-apps/api. This can be added to your project through your preferred method:

pnpm add @tauri-apps/api
yarn add @tauri-apps/api
npm add @tauri-apps/api

Development

gleam run   # Run the project

Further documentation can be found at https://hexdocs.pm/lustre_tauri.