Desktop-ready spending dashboard for QoQa.ch — automatically syncs your orders and PDF invoices to a local SQLite (or PostgreSQL) database and displays spending charts, stats, and a searchable orders table.
- Stats cards — total spent, number of orders, average per order
- Spending charts — monthly and yearly bar + line charts
- Category filter — filter all data by QoQa universe/sub-universe (URL-encoded)
- Orders table — searchable, paginated list of all orders
- Invoice PDF viewer — opens stored invoices in an in-app popup
- Settings modal — configure credentials, database URL, sync locale, and UI language; trigger a full or incremental sync with a live progress log
Standalone desktop apps are available for macOS (Apple Silicon) and Windows — no Bun or Git required.
macOS (recommended — Homebrew):
brew install --cask nyg/tap/qoqa-comptaThis handles the Gatekeeper step for you (see below), so the app launches normally.
Windows (recommended — Scoop):
scoop bucket add nyg https://github.com/nyg/scoop-bucket
scoop install qoqa-comptaScoop installs per-user (no admin rights) and avoids the SmartScreen prompt (see Windows SmartScreen below). If you don't have Scoop, install it first (no admin required):
irm get.scoop.sh | iexManual download:
- Download the installer from the releases page:
- macOS:
…-macos-arm64.dmg - Windows:
…-windows-x64-setup.zip
- macOS:
- macOS: open the DMG, drag QoQa Compta.app to your Applications folder, then see macOS Gatekeeper below before first launch
- Windows: extract the ZIP and run QoQa Compta-Setup.exe inside (installs per-user to
%LOCALAPPDATA%— no admin rights). See Windows SmartScreen below before first launch.
Because the app is not signed with an Apple Developer certificate, macOS quarantines it after download and blocks it on first launch.
The quickest fix is to remove the quarantine flag once, after copying the app to Applications:
xattr -dr com.apple.quarantine "/Applications/QoQa Compta.app"Alternatively, use the GUI path:
- Try to open the app — macOS will show a warning and block it
- Open System Settings → Privacy & Security
- Scroll down to the security section — you will see "QoQa Compta was blocked from use because it is not from an identified developer"
- Click Open Anyway, then confirm in the dialog
You only need to do this once per installation. Installing via Homebrew avoids it entirely.
Because the app is not code-signed, Windows SmartScreen shows "Windows protected your PC" when you run QoQa Compta-Setup.exe. Click More info → Run anyway (this option is only offered to administrators).
Installing via Scoop avoids this prompt entirely.
QoQa Compta uses Bun.
bun install
# Starts the Hono API on :3001 and the Vite dev server on `:3000` concurrently. Open http://localhost:3000.
bun run dev
# Starts the ElectroBun desktop app
bun run desktop:dev
# Runs `vite build` first (via the ElectroBun `preBuild` hook) then packages the app. Output artifacts are in `artifacts/`: `.dmg` for macOS, `.zip` for Windows.
bun run build:stable| Layer | Technology |
|---|---|
| Backend | Hono on Bun — REST API + sync engine |
| Frontend | Vite SPA — React 19, React Router v7, Tailwind v4 |
| Desktop | ElectroBun — native macOS & Windows app |
| Database | SQLite (default, via @libsql/client) or PostgreSQL (via @neondatabase/serverless) |
| i18n | react-i18next — 5 locales: en, fr, de, it, rm |