Repository navigation
Desktop
nodemode-ai edited this page Nov 13, 2026
·
1 revision
The desktop app is a Tauri 2 shell around the same engine and window the browser build uses. It ships two sidecars: the engine frozen with PyInstaller (with the built window, the template library and the font library inside it) and the layout core binary.
| Path | What lives there |
|---|---|
src-tauri/src/main.rs |
the shell: splash, starting the engine sidecar with the core's path, reading the engine's port, opening the main window, the updater |
src-tauri/tauri.conf.json |
product name, identifier ai.nodemode.formdesign, the splash window, bundle targets, file associations, the updater endpoint |
src-tauri/tauri.updater.conf.json |
merged in for signed release builds: turns on updater artifacts |
src-tauri/capabilities/default.json |
core permissions only; the window talks HTTP and WebSocket to its engine |
src-tauri/entitlements.plist |
macOS hardened-runtime entitlements for the frozen Python engine |
src-tauri/icons/ |
resizes of the owner's master assets/formdesign_icon_macos.png, as are the assets/formdesign_*.png icons and the window's favicons; assets/icon_src/README.txt gives the derivation (its older generator scripts draw the previous icon and are not run) |
src-tauri/binaries/ |
formdesign-engine-[triple] and formdesign-core-[triple], written by ./formdesign freeze (ignored by git) |
backend/formdesign_engine.py |
the engine's frozen entry and --selfcheck
|
setup/freeze_backend, install_desktop, desktop_dev, desktop_build (and .bat twins) |
the build scripts |
frontend/public/splash.html |
the splash shown while the engine starts |
- The splash opens (360 by 180, no decorations).
- The shell starts
formdesign-enginewithFORMDESIGN_PORT=8196andFORMDESIGN_COREpointing at theformdesign-corebinary beside the app. - The engine takes 8196 if it is free, or a free port if not, and uvicorn logs the address. The shell reads the port from that line.
- The main window opens at 90 percent of the screen (at least 1100 by 700) on
http://127.0.0.1:[port], and the splash closes. - If the engine never reports a port, the shell shows a dialog and exits. Quitting the app stops the engine, which stops the core.
./formdesign install-desktop # PyInstaller; checks Rust and, on Linux, the webview packages
./formdesign desktop dev # run against a frozen engine (freezes first if needed)
./formdesign desktop build # bundles in src-tauri/target/release/bundle
./formdesign desktop build --bundles deb # one format onlyWindows uses formdesign.bat install-desktop and formdesign.bat desktop build; the batch scripts handle the venv\Scripts layout. ./formdesign freeze alone rebuilds the sidecars and runs the engine's self-check, which reports whether the window, templates and fonts made it into the archive.
| Platform | Bundles | Built and run so far |
|---|---|---|
| Linux x64 |
.deb, .rpm, .AppImage
|
.deb built and launched (0.6.0) |
| macOS arm64 |
.dmg, .app
|
by formcompiler only |
| Windows x64 |
.msi, NSIS -setup.exe
|
by formcompiler only |
- The window inside the app is the same build as the browser's; desktop-only behaviour goes in
src-tauri/src/main.rs, not in the frontend. - Everything the engine reads at run time must be added to the freeze (
--add-datainsetup/freeze_backendand its.battwin) and reported by--selfcheck. - No signing keys in the repository. Signing and the updater key come from formcompiler's GitHub secrets (see Releasing).
FormDesign
Layers
Making layouts
Operations