AI written
I'm tired and bad at writing things, help appreciated - file an issue or PR on GitHub.

Product frontends

Two frontends: swiftui-macos and tauri-webui.

The renderer experiments were useful, but the product surface is intentionally small: one native Apple app and one packaged WebUI app.

Native Apple

swiftui-macos

The SwiftUI app is the primary native macOS frontend. It uses shared Swift code for bundle loading, setup state, localization, configuration, command rendering, and process execution.

make run PLATFORM=swiftui-macos BUNDLE=examples/WGSExtract
make package PLATFORM=swift
Portable WebUI

tauri-webui

The Tauri app packages the TypeScript WebUI and local Node backend as a desktop app. It is the product WebUI shell for cross-platform distribution.

make run PLATFORM=tauri BUNDLE=examples/WGSExtract
make package PLATFORM=tauri

Supporting surfaces are not product frontends

SurfaceRole
Swift CLIBundle inspection, setup, config, and command execution support.
TypeScript Web UI server/clientImplementation layer reused by Tauri and useful for development preview.
TypeScript shared runtimeModel, localization, rendering, and utility code shared by web-based surfaces.
TypeScript TUITerminal-first development and automation path, not a desktop GUI frontend.

The stable product question is narrower than "what code can run?" The two frontends users should think about are swiftui-macos and tauri-webui.

Design rule

Reusable business logic belongs in GUIForCLICore or the shared TypeScript runtime. Presentation, platform integrations, packaging, and native affordances belong in one of the two product frontend shells. Prototype renderers should not add compatibility shims or product claims until they can run the same WGSExtract workflow.