Crate fermi

source ·
Expand description

Fermi ⚛

Atom-based global state management solution for Dioxus

Fermi is a global state management solution for Dioxus that’s as easy as use_state.

Inspired by atom-based state management solutions, all state in Fermi starts as an atom:

static NAME: Atom<&str> = Atom(|_| "Dioxus");

From anywhere in our app, we can read the value of our atom:

fn NameCard(cx: Scope) -> Element {
    let name = use_read(cx, &NAME);
    cx.render(rsx!{ h1 { "Hello, {name}"} })

We can also set the value of our atom, also from anywhere in our app:

fn NameCard(cx: Scope) -> Element {
    let set_name = use_set(cx, &NAME);
        button {
            onclick: move |_| set_name("Fermi"),
            "Set name to fermi"

If needed, we can update the atom’s value, based on itself:

static COUNT: Atom<i32> = Atom(|_| 0);

fn Counter(cx: Scope) -> Element {
    let mut count = use_atom_state(cx, &COUNT);

        p {
        button {
            onclick: move |_| count += 1,
            "Increment counter"

It’s that simple!


Fermi is currently under construction, so you have to use the master branch to get started.

fermi = { git = "" }

Running examples

The examples here use Dioxus Desktop to showcase their functionality. To run an example, use

$ cargo run --example fermi


Broadly our feature set required to be released includes:

  • Support for Atoms
  • Support for AtomRef (for values that aren’t Clone)
  • Support for Atom Families
  • Support for memoized Selectors
  • Support for memoized SelectorFamilies
  • Support for UseFermiCallback for access to fermi from async





  • All Atoms are Readable - they support reading their value.
  • All Atoms are Writable - they support writing their value.

Type Aliases