Electron Desktop

ByteBox can run as an Electron desktop app. Currently available for Linux.

Download

Pre-built Linux installers for v2.4.0:

• ByteBox-2.4.0.AppImage — Universal Linux (any distro)
• bytebox_2.4.0_amd64.deb — Debian / Ubuntu / Mint

Dev Mode

npm run electron:dev

This script compiles Electron main/preload code, launches Next dev server, waits for http://localhost:1334, then opens Electron.

Build Installer

npm run electron:build:linux

Runtime Behavior

• Development: Electron points to Next dev server on port 1334.
• Packaged: Electron starts a bundled Next production server in-process on port 1335.

Migration Handling in Packaged App

On startup, electron/main.ts:

1. Resolves user data directory
2. Sets DATABASE_URL to user DB path
3. Applies pending SQL migrations from bundled prisma/migrations
4. Boots Next server and opens the window

Database Location

Packaged app DB lives in OS user data path and survives upgrades.

Examples:

• Linux: ~/.config/ByteBox/bytebox.db

Notes

• Main process uses secure defaults (contextIsolation, sandbox, no node integration in renderer).
• External links open in system browser.