zephium for linux

[someonevro]

Hi! I got Zephium building and running on Linux, and I'd like to know whether you're interested in this before I open any PRs. I know Linux is on the roadmap and not supported yet, so I'm asking first.

Environment

• CachyOS (Arch-based), KDE Plasma on Wayland, AMD RX 550
• WebKitGTK 4.1 (2.54.2), GTK 3.24
• Rust 1.95.0 (the pinned toolchain), based on bf2f9bd

What works

• cargo check / cargo build / cargo test for zephium-desktop
• The release build launches and shows the onboarding screen
• The KDE global-shortcut portal prompt for the launcher shortcut appears when the app is installed with its .desktop file

Most of the Linux groundwork was already in the tree (WebKitGTK composition, Wayland portal and X11 shortcuts, the .desktop template), so the diff is small.

Changes (about 50 lines)

1. Build without work-product on Linux. zephium-engine's Work modules are gated to macOS/Windows (work_resource, page_recipe, and others), so I build Linux with --no-default-features through new pnpm dev:linux / pnpm build:linux scripts.
2. Remove the two Linux gates: the one in scripts/require-supported-platform.mjs (it now points to the Linux scripts) and the runtime exit(1) at the top of run() in desktop/src/lib.rs.
3. launcher_trigger.rs didn't compile on Linux. It imports tauri_plugin_global_shortcut, which desktop/Cargo.toml deliberately doesn't link on Linux. I gated the plugin code to non-Linux. On Linux, set_shortcut returns Unsupported and recording does nothing, which matches the existing editable: false intent.
4. media.rs didn't compile in any build without work-product. media_admit_remote calls work_provider::record_diagnostic, but work_provider is behind that feature. It now falls back to write_diagnostic.
5. The chrome webview stayed at 1x1, so the window was blank. In platform/linux.rs install_composition, the connect_size_allocate handler calls set_size_request on the chrome. GtkFixed has already allocated the child by the time that handler runs, and the new request only applies on a later layout pass, which never comes while the window size is unchanged. I confirmed this by dumping the widget tree: the window and the Fixed were 1200x800, the WebKitWebView was 1x1. The fix adds sized_chrome.size_allocate(allocation) in the same handler.
6. Packaging: a small PKGBUILD that repackages the Tauri .deb.

Things you may want to know

• AppImage cannot work while the WebKit sandbox is on. linuxdeploy rewrites WebKit's helper paths to ././/bin/bwrap and ././/bin/xdg-dbus-proxy, and bubblewrap can't reach the AppImage mount. It crashes with Failed to start dbus proxy. I didn't disable the sandbox. Native packages (deb/rpm/Arch) using the system WebKitGTK work.
• platform::linux::shortcut_tests::focused_shortcut_requires_exact_non_lock_modifiers fails with GTK has not been initialized. It has never run before, since Linux didn't compile. All other zephium-desktop tests pass.
• I haven't verified macOS/Windows builds after these changes. The edits are all Linux-gated or feature-gated, but I'd run CI before any PR.
• I used claude-code to completely build this.

Questions

1. Do you want Linux PRs now, or would you rather do the port yourself?
2. If yes, how would you like it split? My guess: (a) the media.rs no-Work build fix, (b) the chrome sizing fix plus a test, (c) the launcher_trigger gating, (d) gates, scripts and packaging.
3. Is building Linux without Work acceptable for a first step?

Happy to share the branch or a full diff.

[someonevro]

Update: the Linux build is now public as an unofficial fork, so you can look at the exact changes: https://github.com/someonevro/zephium-linux (branch linux-port, two commits on top of bf2f9bd).

There is also a release with .deb, .rpm and Arch packages: https://github.com/someonevro/zephium-linux/releases/tag/v1.0.4-linux.1

All credit for Zephium goes to you and the contributors. The README and release notes say it is unofficial and not affiliated, and that the name and logo are yours. The port was done with Claude Code.

Since the README says the Zephium name and logo are not licensed under the MPL: are you OK with these Linux binaries using the Zephium name? If not, tell me and I will rename the build or take the binaries down. And if any of these fixes are useful for your own Linux work, I am happy to open PRs split however you prefer.