FloCafe

Español · Português · Français · Türkçe · Filipino · Deutsch · 简体中文 · العربية · اردو

Free, open-source, offline-first point of sale for cafés, restaurants, and small kitchens.

Website · Download · Report a bug

FloCafe runs directly on the business's own computer. Orders, customers, receipts, and backups are stored in a local SQLite database, allowing counter service and kitchen displays to continue operating without an internet connection. No hosted or cloud account is required for core POS operation. Optional integrations—such as Google Drive backup, WhatsApp bill delivery, and cloud-connected reporting—can be enabled when needed.

Get FloCafe

Download the latest installer from GitHub Releases, or install through your platform's app store:

Releases include Windows installers, macOS DMGs, and Linux AppImage, .deb, .rpm, and Snap packages. For Linux package-specific installation and update behavior, FUSE setup, printing permissions, and tray behavior, see Linux installation and support.

System requirements

Requirement	Minimum
Operating system	Windows 10+, macOS 12+, or a current supported Linux distribution — 64-bit only (x64 or arm64)
Memory	4 GB RAM
Storage	500 MB free space, plus room for local backups

Node.js is only required to develop FloCafe, not to run a packaged release.

FloCafe does not build or publish 32-bit installers. A terminal that can only run a 32-bit OS can still be used from a lightweight browser, without installing the desktop app locally:

• Companion screen or POS terminal: open the Server App or the browser POS, both served over LAN.
• KDS station: open the KDS URL listed in the app's About dialog (macOS: the application menu; Windows and Linux: Help). The KDS is a separate LAN-served display on its own port, configurable through KDS_PORT; it is not served from the Server App or the browser POS.

Uninstall a direct-download build

App Store and Microsoft Store installs should be removed through the relevant store or operating system.

# macOS
curl -fsSL https://github.com/FreeOpenSourcePOS/FloCafe/releases/latest/download/uninstall-macos.sh -o uninstall-macos.sh
chmod +x uninstall-macos.sh
./uninstall-macos.sh

# Windows PowerShell
irm https://github.com/FreeOpenSourcePOS/FloCafe/releases/latest/download/uninstall-windows.ps1 -OutFile uninstall-windows.ps1
powershell -ExecutionPolicy Bypass -File .\uninstall-windows.ps1

Both scripts ask whether to keep application data. Do not choose their data-purge options unless you intend to remove the local database and backups.

Key features

High-Speed Counter POS Fast, touch-optimized checkout built for busy café rushes. Filter menu categories with a tap, adjust item quantities on the fly, and accept cash or card payments with zero lag. Getting started guide →
Custom Modifiers & Add-ons Tailor every drink and dish to customer preferences. Configure milk selections (whole, oat, almond), extra espresso shots, syrup flavors, and kitchen prep instructions effortlessly.
Real-Time Kitchen Display (KDS) Keep kitchen staff and baristas in sync with a digital ticket board. Drag orders from waiting to preparing to ready, track prep times, and eliminate lost paper tickets. Kitchen display guide →
Visual Tables & Floor Plan See your entire dining area at a glance. Track occupied and open tables, check how long guests have been seated to optimize turnaround, and view checks instantly.
Handheld Waiter App Take orders right at the table from any smartphone or tablet. Servers select menu items, apply modifiers, and fire tickets directly to the kitchen without walking back to the counter.
Split Payments & Multi-Tender Split bills equally across guests or accept multiple payment types on a single ticket. Handle partial cash, card, and loyalty point redemptions with automatic change calculations.
Supplies & Stock Tracking Manage raw ingredients and café supplies with precision. Record stock deliveries, waste, and manual adjustments, track unit costs, and review complete movement audit logs.
Thermal Receipt & Kitchen Printing Print clean customer receipts and kitchen order slips on standard 58mm or 80mm thermal receipt printers over USB or local network, complete with itemized tax summaries. Printer configuration guide →

Also in the box

• Offline-first architecture: Local SQLite storage with auto-migrating schema and fail-closed safety.
• Granular roles & permissions: Owner, Manager, Cashier, Server, and Chef roles with context-aware access policies.
• Multi-language support: 25 localized languages with full bidirectional RTL rendering (Arabic, Persian, Urdu).
• 131 Country profiles: 109 world currencies with localized phone parsing, number formatting, and timezone handling.
• Country tax packs: Signed regional tax pack integration and manual rule engine.
• Automated database backups: Pre-migration automatic snapshots, manual exports, and optional Google Drive sync.
• Customer loyalty & CRM: Customer directory, purchase histories, and point redemption.
• Cash drawer management: Cash pulse on checkout and end-of-shift cash drawer reconciliations.
• Daily sales & accounting export: Audit-ready CSV/Excel reporting with financial reconciliation identities.

Project status

FloCafe is actively developed and already used in real deployments. Core customer data and upgrade safety are treated carefully, including explicit database migrations and recovery mechanisms. Some internal and extension-facing architecture is still evolving, so implementation details and internal contracts may change as the project matures.

Offline-first by design

Core POS operation and local data are offline-first. Order entry, billing, KDS coordination, and receipt printing do not depend on internet access or external cloud services.

• Data location: The SQLite database and local backups reside in the operating system user-data directory, separate from installed application binaries. Standard in-place application updates do not remove them. As a best practice, create a manual backup before reinstalling, moving to a new machine, or changing distribution channels.
• Pre-migration backups: FloCafe automatically creates a timestamped database backup before running schema migrations.
• Optional network features: Services such as Google Drive backups, WhatsApp bill delivery, and cloud reporting communicate over the network only when explicitly configured and enabled by the store owner.

Languages and regional support

FloCafe includes UI translations for:

• English
• Spanish
• French
• Brazilian Portuguese
• Russian
• Filipino
• Turkish
• Persian (Farsi), including RTL support
• Arabic, including RTL support
• Urdu, including RTL support
• German
• Italian
• Japanese
• Simplified Chinese
• Traditional Chinese (Taiwan)
• Korean
• Bahasa Indonesia
• Dutch
• Hindi
• Bengali/Bangla
• Albanian
• Vietnamese
• Thai
• Nepali

UI language is independent of store country and regional settings, and tax calculation rules remain a separate concern. For details on contributing translations or adding languages, see the Internationalization and translation guide.

FloCafe ships with 131 country profiles covering 109 currencies. Each profile sets a default currency, locale, and setup timezone; store owners can override the timezone during setup or later in Settings.

Supported country profiles, currencies, and default timezones

Country	Currency	Default timezone
India (IN)	INR	Asia/Kolkata
Argentina (AR)	ARS	America/Argentina/Buenos_Aires
United States (US)	USD	America/New_York
Canada (CA)	CAD	America/Toronto
United Kingdom (GB)	GBP	Europe/London
Thailand (TH)	THB	Asia/Bangkok
Singapore (SG)	SGD	Asia/Singapore
Malaysia (MY)	MYR	Asia/Kuala_Lumpur
Indonesia (ID)	IDR	Asia/Jakarta
Philippines (PH)	PHP	Asia/Manila
Vietnam (VN)	VND	Asia/Ho_Chi_Minh
Australia (AU)	AUD	Australia/Sydney
New Zealand (NZ)	NZD	Pacific/Auckland
United Arab Emirates (AE)	AED	Asia/Dubai
Saudi Arabia (SA)	SAR	Asia/Riyadh
South Africa (ZA)	ZAR	Africa/Johannesburg
Morocco (MA)	MAD	Africa/Casablanca
Kenya (KE)	KES	Africa/Nairobi
Nigeria (NG)	NGN	Africa/Lagos
Brazil (BR)	BRL	America/Sao_Paulo
Mexico (MX)	MXN	America/Mexico_City
Chile (CL)	CLP	America/Santiago
Uruguay (UY)	UYU	America/Montevideo
Paraguay (PY)	PYG	America/Asuncion
Japan (JP)	JPY	Asia/Tokyo
South Korea (KR)	KRW	Asia/Seoul
China (CN)	CNY	Asia/Shanghai
Hong Kong SAR China (HK)	HKD	Asia/Hong_Kong
Taiwan (TW)	TWD	Asia/Taipei
Pakistan (PK)	PKR	Asia/Karachi
Bangladesh (BD)	BDT	Asia/Dhaka
Sri Lanka (LK)	LKR	Asia/Colombo
Nepal (NP)	NPR	Asia/Kathmandu
Egypt (EG)	EGP	Africa/Cairo
Israel (IL)	ILS	Asia/Jerusalem
Türkiye (TR)	TRY	Europe/Istanbul
Iran (IR)	IRR	Asia/Tehran
Germany (DE)	EUR	Europe/Berlin
France (FR)	EUR	Europe/Paris
Italy (IT)	EUR	Europe/Rome
Spain (ES)	EUR	Europe/Madrid
Portugal (PT)	EUR	Europe/Lisbon
Netherlands (NL)	EUR	Europe/Amsterdam
Belgium (BE)	EUR	Europe/Brussels
Ireland (IE)	EUR	Europe/Dublin
Austria (AT)	EUR	Europe/Vienna
Greece (GR)	EUR	Europe/Athens
Finland (FI)	EUR	Europe/Helsinki
Luxembourg (LU)	EUR	Europe/Luxembourg
Malta (MT)	EUR	Europe/Malta
Cyprus (CY)	EUR	Asia/Nicosia
Slovakia (SK)	EUR	Europe/Bratislava
Slovenia (SI)	EUR	Europe/Ljubljana
Estonia (EE)	EUR	Europe/Tallinn
Latvia (LV)	EUR	Europe/Riga
Lithuania (LT)	EUR	Europe/Vilnius
Croatia (HR)	EUR	Europe/Zagreb
Switzerland (CH)	CHF	Europe/Zurich
Sweden (SE)	SEK	Europe/Stockholm
Norway (NO)	NOK	Europe/Oslo
Denmark (DK)	DKK	Europe/Copenhagen
Poland (PL)	PLN	Europe/Warsaw
Czechia (CZ)	CZK	Europe/Prague
Hungary (HU)	HUF	Europe/Budapest
Romania (RO)	RON	Europe/Bucharest
Bulgaria (BG)	BGN	Europe/Sofia
Iceland (IS)	ISK	Atlantic/Reykjavik
Serbia (RS)	RSD	Europe/Belgrade
Ukraine (UA)	UAH	Europe/Kyiv
Albania (AL)	ALL	Europe/Tirane
North Macedonia (MK)	MKD	Europe/Skopje
Bosnia & Herzegovina (BA)	BAM	Europe/Sarajevo
Moldova (MD)	MDL	Europe/Chisinau
Georgia (GE)	GEL	Asia/Tbilisi
Armenia (AM)	AMD	Asia/Yerevan
Azerbaijan (AZ)	AZN	Asia/Baku
Qatar (QA)	QAR	Asia/Qatar
Kuwait (KW)	KWD	Asia/Kuwait
Bahrain (BH)	BHD	Asia/Bahrain
Oman (OM)	OMR	Asia/Muscat
Jordan (JO)	JOD	Asia/Amman
Lebanon (LB)	LBP	Asia/Beirut
Iraq (IQ)	IQD	Asia/Baghdad
Yemen (YE)	YER	Asia/Aden
Ghana (GH)	GHS	Africa/Accra
Tanzania (TZ)	TZS	Africa/Dar_es_Salaam
Uganda (UG)	UGX	Africa/Kampala
Ethiopia (ET)	ETB	Africa/Addis_Ababa
Rwanda (RW)	RWF	Africa/Kigali
Côte d’Ivoire (CI)	XOF	Africa/Abidjan
Senegal (SN)	XOF	Africa/Dakar
Cameroon (CM)	XAF	Africa/Douala
Zambia (ZM)	ZMW	Africa/Lusaka
Mauritius (MU)	MUR	Indian/Mauritius
Tunisia (TN)	TND	Africa/Tunis
Algeria (DZ)	DZD	Africa/Algiers
Botswana (BW)	BWP	Africa/Gaborone
Namibia (NA)	NAD	Africa/Windhoek
Mozambique (MZ)	MZN	Africa/Maputo
Angola (AO)	AOA	Africa/Luanda
Kazakhstan (KZ)	KZT	Asia/Almaty
Uzbekistan (UZ)	UZS	Asia/Tashkent
Mongolia (MN)	MNT	Asia/Ulaanbaatar
Myanmar (Burma) (MM)	MMK	Asia/Yangon
Cambodia (KH)	KHR	Asia/Phnom_Penh
Laos (LA)	LAK	Asia/Vientiane
Brunei (BN)	BND	Asia/Brunei
Macao SAR China (MO)	MOP	Asia/Macau
Maldives (MV)	MVR	Indian/Maldives
Bhutan (BT)	BTN	Asia/Thimphu
Afghanistan (AF)	AFN	Asia/Kabul
Guatemala (GT)	GTQ	America/Guatemala
Costa Rica (CR)	CRC	America/Costa_Rica
Panama (PA)	PAB	America/Panama
Dominican Republic (DO)	DOP	America/Santo_Domingo
Honduras (HN)	HNL	America/Tegucigalpa
El Salvador (SV)	USD	America/El_Salvador
Nicaragua (NI)	NIO	America/Managua
Belize (BZ)	BZD	America/Belize
Jamaica (JM)	JMD	America/Jamaica
Trinidad & Tobago (TT)	TTD	America/Port_of_Spain
Bahamas (BS)	BSD	America/Nassau
Barbados (BB)	BBD	America/Barbados
Haiti (HT)	HTG	America/Port-au-Prince
Bolivia (BO)	BOB	America/La_Paz
Ecuador (EC)	USD	America/Guayaquil
Colombia (CO)	COP	America/Bogota
Peru (PE)	PEN	America/Lima
Venezuela (VE)	VES	America/Caracas
Fiji (FJ)	FJD	Pacific/Fiji
Papua New Guinea (PG)	PGK	Pacific/Port_Moresby

Tax support

FloCafe includes a generic calculation engine and supports signed, versioned country tax packs for regional rules, tax categories, and rounding policies. Country coverage is expanding through the catalog, and availability varies. Operators can also configure manual tax rules and rates locally.

Notice: FloCafe is software, not legal or tax advice. Tax packs and configuration tools do not by themselves certify compliance with local regulations. Operators remain responsible for verifying the requirements that apply to their business.

For pack authoring, validation, and schema details, see the Tax packs developer guide.

Development

Setting up a local development environment requires Node.js 22 or later:

git clone https://github.com/FreeOpenSourcePOS/FloCafe.git
cd FloCafe
npm install
npm run dev

npm run dev builds the frontend and backend, then launches Electron.

Architecture

Electron main process
├── Express API and WebSocket server       :3001
├── Standalone kitchen-display server      :3002
├── Server / waiter app server             :3003
└── SQLite database, migrations, and printing
                 ↕ HTTP and WebSocket
Next.js renderer
└── React UI and Zustand client state

For detailed developer workflows, coding standards, branch conventions, and testing procedures, see CONTRIBUTING.md.

Contributing

Contributions are welcome. Please check CONTRIBUTING.md before starting work:

• Small bug fixes, documentation improvements, and focused tests can be started freely.
• New features, database schema changes, and architectural refactors require maintainer discussion and approval before implementation.

If FloCafe is useful to you, consider starring the repository.

Help and documentation

• Documentation index: docs/README.md
• Printer guide & troubleshooting: docs/printers.md
• Linux setup & support: docs/linux.md
• Internationalization & translations: docs/architecture/internationalization.md
• Google Drive backup setup: docs/google-drive-setup.md
• Bug reports & feature proposals: GitHub Issues
• General questions & ideas: GitHub Discussions

License

FloCafe is open-source software licensed under the MIT License.