#native-gui

Formerly moonbit-libyue (renamed 2026-10). The mooncakes package is NoahLiu/native-gui and all existing import paths are unchanged.

#Highlights

• Self-drawn widgets, one look everywhere — the library's own rasterizer draws every control, so rendering is identical across platforms; light/dark mode and the system accent colour are followed by default, and the theme is fully customizable.
• Declarative UI with reactive state — describe the interface as a tree of @widget.Node values and mount it with one mount_window call; keep state in Store / Signal and bound spots refresh themselves.
• Desktop-grade system integration — tray, notifications, native menus, global shortcuts, message boxes, file dialogs, drag & drop (in-app and cross-application), clipboard, autostart, idle detection and OS queries (volume, power, monitors, browser history, installed apps…) behind one @sys / @shell facade.
• Content batteries included — 20 chart types with a cross-cutting interactive layer, a GFM Markdown view and multi-language code highlighting in the box; the embedded WebView (JS interop, custom protocols, DOM capture, policy hooks) and the audio/video engine (subtitles, speed control) live in the optional modules gui-webview / gui-media.
• Honest degradation — every capability family exposes a probe and returns a structured Unsupported / NotFound on environments that lack it, instead of crashing or pretending success.
• Pay only for what you import — 15 packages in this module; an unimported package never enters your binary. Heavier optional capabilities (the WebView and the media engine) live in their own modules, outside the default dependency closure entirely.

#Usage

moon add NoahLiu/native-gui

fn main {
  let app = match @ui.mount_window(
    [@ui.text("Hello, MoonBit!", font_size=18.0)],
    title="Hello, MoonBit!",
    width=400,
    height=300,
  ) {
    None => return // no window backend or no display service on this host
    Some(a) => a
  }
  app.run()
}

moon run examples/hello          # a minimal window
moon run examples/hello-themed   # the themed widget set
moon run examples/showcase       # full demo board: components + system probes + extended charts, 15 pages
moon run examples/browser        # embedded WebView browser (demo menu + status bar)

#Packages

#Platform support

#Roadmap

1. Lower the barrier to entry — a shortest path from "install moon" to "a window on screen" on the docs homepage, per-platform prerequisites in one sentence, build errors that carry their own fix hints.
2. Credibility — CI gates on Linux and Windows for every batch, on-device verification checklists, and a version promise: the stable-surface list (what will not break within 1.x) and the 1.0 cut-off are being defined.
3. Content — usage documentation rewritten for the self-drawn stack (tutorials, a per-component guide with screenshots), continuously expanded examples.
4. Platform coverage — closing on-device verification for macOS; verifying the Linux compatibility span floor by floor (deepin 20 as the floor, Ubuntu 26 as the ceiling).

#Documentation

• Repository root README — architecture, package map, contributing and gates
• Documentation site — usage docs, Chinese version under /zh/
• Platform adaptation notes — field-tested pitfalls, root causes and fixes per platform
• Public roadmap (Chinese) — positioning, support matrix, commitments, non-goals