superfast declarative application framework

Write your UI in .zge, a markup language compiled to Zig at build time. Bind it to a reactive core, and render it anywhere from a desktop GPU to a microcontroller drawing one line at a time.

Zig 0.16.0MIT licensedPre-1.0CI on Linux · macOS · Windows
ui/app.zge
Hello

Clicked 0 times

Why zigulee

One UI, every screen

In the spirit of Slint and QML: you describe the interface, a reactive core keeps it up to date, and a set of small backends puts it on screen.

{}

Compiled, not interpreted

.zge compiles to plain Zig structs in a build.zig step. Each component gets typed properties, callbacks and elements, and the compiler reports errors at the exact line and column in your source.

⇄

Reactive core

Property(T) discovers dependencies at runtime and re-evaluates lazily. It detects binding loops, supports two-way links, and doesn't allocate in steady state.

▦

Partial redraws

The renderer records each item's dependencies and a hash of what it drew. Only pixels that actually changed get repainted, on the GPU or in software.

µ

Down to the MCU

The same framework runs bare-metal on ESP32-S3 and Cortex-M. It renders line by line in Rgb565, with no framebuffer and no platform clock.

Aa

Text, in pure Zig

A built-in TrueType reader handles GPOS kerning, hinting, fallback fonts and bidirectional text with Arabic shaping, all without C libraries.

⚡

Live tooling

A viewer that reloads on save, a language server, a formatter, a VS Code live preview with Alt+click to source, and a stable C API.

PlatformBackendsRendering
macOSAppKit (native), SDL3Metal, software
WindowsWin32 (native), SDL3Direct3D 12 (native), OpenGL or Vulkan (SDL3), software
LinuxX11, Wayland, KMS (no desktop), fbdev, SDL3OpenGL or Vulkan (SDL3), software
iOS · iPadOS · CatalystUIKitMetal, software
WebWebAssemblyWebGL, software
MicrocontrollersBare metal (ESP32-S3, Cortex-M)Software, line by line
Quick start

A window in four steps

We'll build a counter: a .zge UI, compiled at build time and run from Zig in an SDL3 window. You'll need Zig 0.16.0.

Create a project

Start a minimal Zig project and add zigulee as a dependency.

terminal

Describe the UI

Components declare properties (var in-out) and callbacks. Bindings like "Clicked \{count} times" update on their own.

ui/app.zge

Compile it in build.zig

uiModuleFromDependency runs the .zge compiler and gives you a Zig module to import.

The first build fetches SDL and compiles it from source, which takes a while. On macOS you'll need Xcode.

build.zig

Run it from Zig

Create the component, give it a font (zigulee doesn't ship one), implement its callbacks, and open a window.

The repository bundles Inter in examples/fonts. Put the font next to main.zig, then run zig build run.

src/main.zig
How-tos

Recipes for real apps

Short answers to the questions that come up once the counter works. Click a card to expand it.

The .zge language

Declarative, typed, reactive

.zge started from Slint's syntax and borrows from QML (anchors, implicit sizes, Canvas), going its own way where neither fits. It compiles to Zig, or runs interpreted in the viewer and the editor preview.

intfloatboolstringlengthdurationanglepercentcolorbrushimage[T] modelsstructenumcomponent
Components

Widgets & elements

45 standard widgets, written in .zge themselves and imported from std-widgets.zge, plus 69 built-in elements. Open any of them for its abstract, how to use it, the full property list and an example that compiles with zgec.

fluent

Windows 11. This is the default style.

cupertino

macOS: 13 px text, accent blue, focus glow.

material

Google's Material Design.

minimal

Flat black and white, for small displays and MCUs.

Roadmap

Where it's going

zigulee is pre-1.0. It's complete enough to build real applications, but APIs may still change. Here's the plan by phase, plus how it compares with Qt Quick.

Qt Quick parity

donepartialmissing

Next up

  • Android backend, built with the NDK and SDK
  • Sensors & location, extended to more platforms
  • Tooling: a linter, a profiler for binding and frame times, and a visual designer on top of the live viewer
  • Accessibility on UIA and AT-SPI, checked with real screen readers
  • Performance: measurements on Raspberry Pi
  • Language: var and list<T> of anything (in proposal)
  • Widgets: ColorDialog, FontDialog, RoundButton, DelayButton