How freeopensourcepos/flocafe works
FloCafe is an offline-first desktop POS for cafés and small restaurants, with browser-accessible POS and separate LAN-served displays. Staff configure the store, manage its catalog and tables, enter and settle orders, and coordinate kitchen work; the local API and SQLite database support these workflows. The README also documents printing, inventory, reporting, staff permissions, backups, and optional Google Drive, WhatsApp, and cloud services. Links among unsampled feature areas follow README capability statements or SOURCE INDEX references; their internal details are not established by the excerpts.
Main entry points: db.ts SQLite and backups · index.ts API route registry · server.ts Local API server · orders.ts Order and billing routes
Components 20
Staff experience
- POS and dashboards
frontend/src/app/(dashboard)/pos/page.tsx - Store setup
frontend/src/app/setup/page.tsx - Kitchen display
frontend/src/app/(dashboard)/kds/page.tsx - Server App
main/server-app.ts
Local application services
- Local API server
main/server.ts - API route registry
main/routes/index.ts - Order and billing routes
main/routes/orders.ts - Catalog routes
main/routes/products.ts - Admin and reporting routes
main/routes/settings.ts - Role permissions
main/services/authorization.ts
Store operations
- Kitchen coordination
main/services/kds.ts - Inventory and recipes
main/services/inventory.ts - Sales reports
main/routes/reports.ts
Local data and recovery
- SQLite and backups
main/db.ts
Print and optional integrations
- Receipt and kitchen printing
main/printers/thermal.ts - Google Drive backup
main/services/google-drive.ts - WhatsApp delivery
main/services/whatsapp.ts - Cloud sync
main/services/cloud-sync.ts
Other components
- Store staff
- External services
Connections 23
- Store staff → POS and dashboards: uses
README.md - Store staff → Store setup: configures
README.md - POS and dashboards → Local API server: requests
- Kitchen display → Kitchen coordination: coordinates
- Server App → Local API server: serves alongside
- Local API server → API route registry: registers
main/server.ts - API route registry → Order and billing routes: registers
main/routes/index.ts - API route registry → Catalog routes: registers
main/routes/index.ts - API route registry → Admin and reporting routes: registers
main/routes/index.ts - API route registry → Role permissions: guards with
main/routes/index.ts - Order and billing routes → SQLite and backups: reads and writes
- Catalog routes → SQLite and backups: reads and writes
- Admin and reporting routes → SQLite and backups: manages
- SQLite and backups → Inventory and recipes: stores records for
- SQLite and backups → Sales reports: supplies data to
- Order and billing routes → Receipt and kitchen printing: prints receipts
- Order and billing routes → WhatsApp delivery: delivers bills via
- Local API server → Kitchen coordination: coordinates
main/server.ts - SQLite and backups → Google Drive backup: backs up to
main/services/google-drive.ts - External services → Google Drive backup: stores backups
README.md - External services → WhatsApp delivery: delivers messages
README.md - Local API server → Cloud sync: starts
main/index.ts - Cloud sync → External services: syncs optionally
README.md