Applications built on fizzy as a library, from outside fizzy.

zig build run-fizzy                  # the studio shape
zig build run-fizzy -Dshape=minimal
zig build run-fizzy -Dshape=endless
zig build run-fizzy -Dshape=studio -Dzon-layout=true

Each is a whole fizzy app: fizzy's frame, its built-in plugins (files, text, images, markdown), in a layout of this repo's own, with two more plugins bundled in. Each shape gets its own executable, window title and config directory (minimalapp, studioapp, endlessapp).

zig build run-replay is a plain dvui app, nothing of fizzy, with tape playback from the plugin SDK's replay (replay/main.zig). At launch it plays a live tape into its own window (clicks, typing, a command), draws the tape's pointer, stops if you click or type, and when the tape ends prints what is on screen as text: the names a test or an automation client reads instead of pixels. It depends only on the SDK package.

zig build run-dvui is a plain dvui app on fizzy's backend (dvui/main.zig): dvui's own widgets and its demo, and OS windows opened with dvui's own dvui.osWindow — nothing but dvui in the app's code. On fizzy's backend each is drawn from the one dvui.Window and looks as a dvui floating window does (its header and close button, no OS title bar); the OS moves it by its header, and it resizes from its edges. fizzy.addDvui gives the app dvui and the backend. -Ddvui-backend=sdl3 builds the same code on dvui's own SDL3 backend, where dvui.osWindow opens a dvui.Window of its own, as dvui does anywhere. Menus and dialogs as OS windows of their own come later.

A shape is the app's layout: one file, ordinary code over fizzy's public Layout API. Fizzy does not configure shapes; you pick the closest one, copy it into your app and change it.

A shape exports pub fn layout(ctx: ?*anyopaque, f: *Layout) !dvui.App.Result and imports only dvui, app, core and fizzy_sdk.

• hello, from fizzyedit/example-plugin: a plugin from its own repo, bundled in by URL as any third-party plugin would be.
• shader (plugins/shader): this app's own plugin, drawing liquid metaballs that follow the pointer with its own GPU program (core.programs). It also builds alone as a dylib (cd plugins/shader && zig build).

build.zig hands both to fizzy with fizzy.buildApp, in one list with the fizzy plugins the app links (fizzy.plugins.text, or fizzy.plugins.all), and every one is linked in and registered the same way. The minimal shape links only workbench and text; the others link all of fizzy's. workbench is required for now.

build.zig is the whole recipe: depend on fizzy (build.zig.zon), call b.dependency("fizzy", …) with your app's name, display name, bundle id, .@"defer-app" = true and your shape as app-layout, then fizzy.buildApp with every plugin you link, fizzy's among them. Pin fizzy by commit, as this repo does.