Desktop App

Alongside the self-hosted web app, Pelagica is available as a native desktop app for macOS, Windows, and Linux, built with Wails v3.

Installing

Download the latest build for your platform from the Releases page.

• macOS: Not notarized, so Gatekeeper will flag it — right-click the app and choose “Open” to bypass.
• Windows: Not signed with an Authenticode certificate, so SmartScreen will flag it.
• Linux: Available as a .deb package or an .AppImage.

Building it yourself

If you’d rather build the desktop app from source, clone the repository as described in Development Setup, then build with Task:

task desktop:build

This produces a desktop/bin/pelagica binary.

Packaging an installer

Platform	Command	Output
macOS	task desktop:package:macos	desktop/bin/Pelagica.app
	task desktop:installer:macos	desktop/bin/Pelagica.dmg
Windows	task desktop:package:windows	desktop/bin/pelagica.exe
	task desktop:installer:windows	desktop/bin/Pelagica-amd64-installer.exe
Linux	task desktop:package:linux	desktop/bin/pelagica
	task desktop:installer:linux:deb	desktop/bin/pelagica.deb
	task desktop:installer:linux:appimage	desktop/bin/pelagica-x86_64.AppImage

A few platform-specific tools are needed on top of the usual development prerequisites:

• macOS: create-dmg for the .dmg (brew install create-dmg).
• Windows: NSIS for the installer (winget install NSIS.NSIS, or choco install nsis). The Microsoft Edge WebView2 bootstrapper is downloaded automatically on first build.
• Linux: A C compiler and the GTK4 + WebKitGTK 6.0 dev headers, since the Linux build uses cgo (Ubuntu/Debian: apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-dev). The AppImage build additionally downloads linuxdeploy on first run.

None of the produced installers are code-signed or notarized.

See the desktop README in the repository for more detail on the build setup.