Platform & Tooling

Desktop App

Desktop App

WhoDB ships a desktop app built with Wails. It uses the same frontend and backend logic as the web app, but adds native desktop integrations for files, menus, dialogs, and window management.

Desktop-Specific Features

Native File Dialogs

Use native save dialogs for exports and native open dialogs for SQLite and DuckDB file selection.

Application Menu

The desktop shell adds File, View, Database, Window, and Help menus with native accelerators.

Window State

Window size and position are persisted between launches.

About Dialog

The Help menu exposes a native About dialog.

Current Menu Actions

The desktop menu currently wires native actions for:

  • new connection
  • export data
  • import data (Cmd/Ctrl + I)
  • refresh
  • toggle sidebar
  • execute query
  • new scratchpad page
  • disconnect
  • documentation and issue links
  • About dialog

A standard Edit menu (cut, copy, paste, and related actions) is also included for native clipboard handling.

File-Based Databases

The desktop app adds native file pickers for:

  • SQLite database files
  • DuckDB database files

This makes file-based logins smoother than the plain browser flow.

Credential Storage

The desktop app stores saved connection credentials in the operating system keyring (under the service name "WhoDB"). It falls back to local config storage only if no keyring is available on the machine.

Updates

Update the desktop app by downloading the latest version from the GitHub releases page and installing it over your existing copy.

Installation

Choose between Docker, binary, source, and desktop workflows.

CLI & MCP

See the separate terminal and MCP tooling surface.