Getting Started

What is FloCafe? Architecture & Operating Principles

Understand FloCafe’s offline-first architecture, local database authority, hardware requirements, and multi-station capabilities.

All Roles 5 min read v3.12.88 Updated 2026-10-12

Prerequisites & Requirements

  • A computer running Windows 10/11 (64-bit), macOS 12+ (Apple Silicon or Intel), or modern Linux.
  • At least 4 GB RAM and 500 MB free disk space.
  • A local network router or WiFi access point if using secondary screens or printers.

FloCafe is a professional, open-source, offline-first point of sale designed for cafés, bakeries, quick-service restaurants, and fine dining establishments. Unlike cloud-only POS systems, FloCafe stores all transactions, inventory, and customer records locally in SQLite on your device.

Architecture & Workflow Diagram
What is FloCafe? Architecture & Operating Principles Architecture Diagram
FloCafe local area network topology: Host PC with local SQLite running API (:3001), KDS (:3002), and Server App (:3003).
What is FloCafe? Architecture & Operating Principles Screenshot
FloCafe desktop POS running locally on Blue Harbor Café’s point of sale terminal.

Core Operating Invariants

FloCafe operates on fundamental principles designed to guarantee restaurant continuity during busy service:

  • Offline-First Operation: Taking orders, printing receipts, updating KDS tickets, and closing shifts work with zero internet connectivity. Internet is only required for optional cloud features like Google Drive backups or WhatsApp messaging.
  • Backend Authority: All financial calculations, taxes, discounts, and permissions are enforced by the local Express server (:3001).
  • No Ownership Gating: Staff members with appropriate role permissions can view and update any order in service, preventing bottlenecks if a waiter takes a break.
  • Data Safety: Customer records, transaction history, and stock logs persist across version upgrades.

Supported Hardware

FloCafe supports standard commercial POS hardware:

  • Thermal Receipt Printers: 58mm and 80mm ESC/POS printers via USB, Ethernet LAN, or WiFi.
  • Cash Drawers: Standard RJ11/RJ12 drawer connected through the thermal receipt printer with automated pulse.
  • Barcode Scanners: USB HID and wireless barcode scanners for instant product lookup.
  • Secondary Displays: Kitchen Display System (port 3002) and Customer Facing Status Display (port 3001/customer-display) on tablets or HDMI monitors.
Zero Cloud Lock-In
Your financial data is stored locally in an open SQLite database. You retain 100% ownership of your business records without monthly subscription lock-in.

No sales call. No card.

Need more help with What is FloCafe? Architecture & Operating Principles?

Install it, load a real menu, and run a full service before you trust it with a Friday night.

Join WhatsApp group