Skip to content

Releases: FreeOpenSourcePOS/FloDesktop

v1.5.6 — transaction hardening + printer fix

22 Apr 20:06

Choose a tag to compare

v1.5.6 — Enterprise-grade transaction hardening + printer format fix

Data integrity

  • Every multi-statement mutation (order creation, order item add/cancel/restore, order status, bill generate/payment/discount, addon group create/delete) now runs inside an atomic SQLite transaction via a new withTxn() helper. No more partial writes if the process dies mid-flight.
  • Startup now runs PRAGMA integrity_check + PRAGMA foreign_key_check and logs any violations.
  • Self-healing auto-repair for a pre-fix bills.payment_details corruption where payment JSON was stored as {A},{A} instead of [A]. Idempotent, only fixes rows whose math still balances.
  • Added busy_timeout=5000 and synchronous=NORMAL pragmas — concurrent KDS writes no longer throw SQLITE_BUSY.
  • On final payment, lingering pending/preparing/ready order_items are bulk-closed to served to prevent the "completed order with stuck KDS items" split-brain.

Printer

  • Fixed column alignment bug in all three receipt templates (compact, classic, detailed) where product name wasn't padded to its column width, producing mangled output like Cheeseburger2 5% ₹540.00. Now reads cleanly on both 58mm and 80mm paper.
  • Refactored receipt rendering to shared itemHeader / itemRow / addonRow helpers.

Misc fixes

  • Removed the dropAllTables() footgun (violated AGENTS.md rule #1).
  • DevTools no longer opens automatically for packaged end users (gated behind isDev).
  • Backup _flo_meta.app_version now stores the real app version instead of the schema version.
  • README download filenames / latest-version synced.
  • Fixed build:all script name in README (was build:all-platforms).

Tests

  • npm test runs backup + printer + db-audit suites.
  • npm run test:printer -- --live sends a real test page to your default printer.
  • npm run test:db-audit walks PK/FK/orphans/JSON/math sanity.
  • npm run repair:payments -- --apply one-time repair for the legacy payment_details bug (auto-runs on app startup too).
  • Tests use Node 22.5+ built-in node:sqlite so they run without rebuilding better-sqlite3 against system Node.

Downloads (macOS)

File Arch SHA-256
Flo-1.5.6.dmg Intel (x64) e450268fb4723e3ec4265aaff78d435a3db660a7b848f942d5f660a13b557fec
Flo-1.5.6-arm64.dmg Apple Silicon (arm64) 27bcc7adcf757f23b52758617e31ffea8c1908d4634ae04c0e2e170080094f28

⚠️ These DMGs are unsigned — the Codify Apps Private Limited (BKDY677XJA) Developer ID cert wasn't in the keychain at build time. Users will see a Gatekeeper warning. To sign, re-run npm run build:mac after importing the cert, or distribute via a separate signed channel.

Windows and Linux builds not included — build from source with npm run build:win / npm run build:linux on the respective platforms.

v1.5.1 - Printer Fixes

11 Apr 17:58

Choose a tag to compare

v1.5.1 - Printer Fixes

Bug Fixes:

  • Add default printer to seedData after migration
  • Fix header column alignment in receipt templates
  • Prevent printer config loss on database migration

Downloads:

  • macOS: Flo-1.5.1.dmg, Flo-1.5.1-arm64.dmg
  • Windows: Flo Setup 1.5.1.exe
  • Linux: Flo-1.5.1.AppImage, flo-desktop_1.5.1_amd64.deb

Flo v1.4.0

06 Apr 05:17

Choose a tag to compare

v1.4.1 - Signed & Notarized for macOS

macOS (Signed)

  • Flo-1.4.1-signed.dmg (Intel)
  • Flo-1.4.1-arm64-signed.dmg (Apple Silicon)

Windows

  • Flo.Setup.1.4.1.exe

Features

  • Staff: Edit, password reset, fixed roles dropdown
  • Customers: Edit functionality
  • Orders redesign, KDS standalone server, prepaid flow

Flo v1.1.0

30 Mar 18:14

Choose a tag to compare

Flo v1.1.0 - Bug Fix Release

Fixed Issues

  • POS Page: Fixed "Failed to load menu data" error
  • Products Page: Fixed "Failed to load products" error
  • Tables Page: Fixed "Failed to load tables" error
  • Customers Page: Fixed "Failed to load customers" error

Changes

  • Renamed "FloPos" to "Flo" across the application
  • Added logo-white.png for dark mode themes

Downloads

  • macOS (Intel): Flo-1.1.0.dmg
  • macOS (Apple Silicon): Flo-1.1.0-arm64.dmg
  • Windows: Flo Setup 1.1.0.exe

FloPos Desktop v1.0.0

30 Mar 15:05

Choose a tag to compare

Initial release with cloud auto-update support

Features:

  • Cloud-based auto-updates via GitHub Releases
  • KDS WebSocket page with connection status
  • SQLite database with auto-seeding (admin@flopos.local / admin123)
  • File-based logging at ~/Library/Logs/flopos-desktop/
  • Fixed frontend path and better-sqlite3 native module packaging

Default Login: