Desktop app overview

Electron + SQLite desktop POS; how it fits next to the dashboard and plugins.

Stack

The desktop app (apps/desktop) is Electron + React + Vite. Business data lives in SQLite via @bodegasuite/db (Drizzle). Plugins run in the main process behind a permissioned API — see the monorepo harness doc docs/harness/plugin-system.md.

Operator workflow

Typical retail flows (POS, inventory, catalog, settings) run locally. Sync, backups, and marketplace install flows integrate with the web dashboard where documented in product specs under docs/02-product/.

For developers

Clone the monorepo and follow the root README.md (Node 24.x, pnpm install, pnpm dev / pnpm dev:desktop).
Renderer UI uses @bodegasuite/ui (Tailwind + shadcn-style primitives) with shared semantic tokens documented in docs/03-technology/10-brand-and-visual-identity.md.