More on gpui — Crux + gpui · Rust Munich 2026/Q2

# More on gpui

Optional reading. Skim if a slide raised a question.

---
## `Entity`, `Context`, `cx.notify()`

gpui's state model:

- Long-lived state lives in an `Entity<T>` — a handle the framework owns.
- Methods on an entity take a `&mut Context<T>` — your window into the
  framework (spawn tasks, subscribe to events, request a redraw…).
- After you mutate `&mut self`, call `cx.notify()` to tell gpui *"I'm dirty,
  please re-run my `render`."*

In our shell:

```rust
Effect::Render(_) => {
    self.view_model = self.core.view();
    cx.notify();
}
```

That's the dirty flag in action.

---
## `cx.spawn` vs `cx.background_executor().spawn`

- `cx.spawn(...)` — schedules work that needs to come back to the **main**
  thread (typical UI updates).
- `cx.background_executor().spawn(...)` — pushes work to a **background**
  thread. We use it for the blocking `ureq` call.

Pattern in `handle_effects`:

```rust
cx.spawn(async move |weak, acx| {
    let result = acx
        .background_executor()
        .spawn(async move { weather::fetch_munich_weather_blocking() })
        .await;
    let _ = weak.update(acx, |shell, cx| { /* … */ });
}).detach();
```

- `weak` is a weak handle to the `Shell` entity, so we don't keep it alive
  forever.
- `.detach()` says "run to completion, I don't need to await you here."

---
## `Render` and `IntoElement`

```rust
impl Render for Shell {
    fn render(&mut self, _w: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
        div().child(...)
    }
}
```

`render` is called whenever gpui needs to redraw your entity. You return
*anything* that implements `IntoElement` — usually a `div(...)` tree.

`div()` is just a layout node, not an HTML `<div>`. The naming is borrowed
from the web because the mental model is similar.

---
## The Tailwind-inspired DSL

Each layout method returns the same builder, so you can chain them:

```rust
div().flex().flex_col().items_center().gap_6()
```

is the same kind of code as

```html
<div class="flex flex-col items-center gap-6">
```

— but type-checked, autocompleted, and refactorable.

A non-exhaustive lookup table is on the [Tailwind bridge](../12-tailwind-bridge.md)
slide.

---
## gpui-component's `init(cx)`

```rust
gpui_component::init(cx);
```

This **must** run before you use any `gpui_component` widget. It registers
the theme, key bindings, notification and tooltip globals. Skip it and
widgets like `Tag` will panic with confusing errors.

---
## Further reading

- gpui in the Zed repo: <https://github.com/zed-industries/zed/tree/main/crates/gpui>
- gpui-component repo: <https://github.com/longbridge/gpui-component>