FloCafe

Free, open-source, offline-first Point of Sale for cafes, restaurants, and food businesses.

Automatically checked · GitHub checked 2026-11-12

FloCafe

Before you switch

Evaluate hosting, migration and feature requirements before switching.

Overview

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

Latest release Total release downloads MIT License Windows, macOS, and Linux CI status

FloCafe POS screen showing product selection and an active dine-in order

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:

Download on the Mac App Store Download from Microsoft Store Install from the Snap 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

RequirementMinimum
Operating systemWindows 10+, macOS 12+, or a current supported Linux distribution — 64-bit only (x64 or arm64)
Memory4 GB RAM
Storage500 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 →

FloCafe counter POS checkout flow with cart item selection and cash payment confirmation

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.

FloCafe modal modifier selector choosing oat milk and espresso shots

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 →

FloCafe standalone Kitchen Display System Kanban board tracking tickets across prep stages

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.

FloCafe interactive floor plan and table turnover monitoring

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.

FloCafe handheld mobile waiter app taking orders table-side

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.

FloCafe equal share split payment calculator dividing check across diners

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.

FloCafe inventory management with supplies, recipe portions, and stock movement 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 →

FloCafe thermal printer test interface for 58mm and 80mm receipts and KOT tickets

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: 32 localized languages with full bidirectional RTL rendering (Arabic, Persian, Urdu).
  • 245 Country profiles: 153 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.
  • Multi-counter ordering: Separate order capture, cashier payment, or combined counter terminals with shared LAN queue and QR ticket lookup.

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
  • Hausa
  • Javanese
  • Marathi
  • Swahili
  • Punjabi
  • Telugu
  • Tamil
  • Ukrainian

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 245 country profiles covering 153 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
CountryCurrencyDefault timezone
India (IN)INRAsia/Kolkata
Argentina (AR)ARSAmerica/Argentina/Buenos_Aires
United States (US)USDAmerica/New_York
Canada (CA)CADAmerica/Toronto
United Kingdom (GB)GBPEurope/London
Thailand (TH)THBAsia/Bangkok
Singapore (SG)SGDAsia/Singapore
Malaysia (MY)MYRAsia/Kuala_Lumpur
Indonesia (ID)IDRAsia/Jakarta
Philippines (PH)PHPAsia/Manila
Vietnam (VN)VNDAsia/Ho_Chi_Minh
Australia (AU)AUDAustralia/Sydney
New Zealand (NZ)NZDPacific/Auckland
United Arab Emirates (AE)AEDAsia/Dubai
Saudi Arabia (SA)SARAsia/Riyadh
South Africa (ZA)ZARAfrica/Johannesburg
Morocco (MA)MADAfrica/Casablanca
Kenya (KE)KESAfrica/Nairobi
Nigeria (NG)NGNAfrica/Lagos
Brazil (BR)BRLAmerica/Sao_Paulo
Mexico (MX)MXNAmerica/Mexico_City
Chile (CL)CLPAmerica/Santiago
Uruguay (UY)UYUAmerica/Montevideo
Paraguay (PY)PYGAmerica/Asuncion
Japan (JP)JPYAsia/Tokyo
South Korea (KR)KRWAsia/Seoul
China (CN)CNYAsia/Shanghai
Hong Kong SAR China (HK)HKDAsia/Hong_Kong
Taiwan (TW)TWDAsia/Taipei
Pakistan (PK)PKRAsia/Karachi
Bangladesh (BD)BDTAsia/Dhaka
Sri Lanka (LK)LKRAsia/Colombo
Nepal (NP)NPRAsia/Kathmandu
Egypt (EG)EGPAfrica/Cairo
Israel (IL)ILSAsia/Jerusalem
Türkiye (TR)TRYEurope/Istanbul
Iran (IR)IRRAsia/Tehran
Germany (DE)EUREurope/Berlin
France (FR)EUREurope/Paris
Italy (IT)EUREurope/Rome
Spain (ES)EUREurope/Madrid
Portugal (PT)EUREurope/Lisbon
Netherlands (NL)EUREurope/Amsterdam
Belgium (BE)EUREurope/Brussels
Ireland (IE)EUREurope/Dublin
Austria (AT)EUREurope/Vienna
Greece (GR)EUREurope/Athens
Finland (FI)EUREurope/Helsinki
Luxembourg (LU)EUREurope/Luxembourg
Malta (MT)EUREurope/Malta
Cyprus (CY)EURAsia/Nicosia
Slovakia (SK)EUREurope/Bratislava
Slovenia (SI)EUREurope/Ljubljana
Estonia (EE)EUREurope/Tallinn
Latvia (LV)EUREurope/Riga
Lithuania (LT)EUREurope/Vilnius
Croatia (HR)EUREurope/Zagreb
Andorra (AD)EUREurope/Andorra
Åland Islands (AX)EUREurope/Mariehamn
Monaco (MC)EUREurope/Monaco
Montenegro (ME)EUREurope/Podgorica
San Marino (SM)EUREurope/San_Marino
Vatican City (VA)EUREurope/Vatican
Kosovo (XK)EUREurope/Belgrade
Switzerland (CH)CHFEurope/Zurich
Sweden (SE)SEKEurope/Stockholm
Norway (NO)NOKEurope/Oslo
Denmark (DK)DKKEurope/Copenhagen
Poland (PL)PLNEurope/Warsaw
Czechia (CZ)CZKEurope/Prague
Hungary (HU)HUFEurope/Budapest
Romania (RO)RONEurope/Bucharest
Bulgaria (BG)BGNEurope/Sofia
Iceland (IS)ISKAtlantic/Reykjavik
Serbia (RS)RSDEurope/Belgrade
Ukraine (UA)UAHEurope/Kyiv
Albania (AL)ALLEurope/Tirane
North Macedonia (MK)MKDEurope/Skopje
Bosnia & Herzegovina (BA)BAMEurope/Sarajevo
Moldova (MD)MDLEurope/Chisinau
Georgia (GE)GELAsia/Tbilisi
Armenia (AM)AMDAsia/Yerevan
Azerbaijan (AZ)AZNAsia/Baku
Belarus (BY)BYNEurope/Minsk
Faroe Islands (FO)DKKAtlantic/Faroe
Guernsey (GG)GBPEurope/Guernsey
Gibraltar (GI)GIPEurope/Gibraltar
Isle of Man (IM)GBPEurope/Isle_of_Man
Jersey (JE)GBPEurope/Jersey
Liechtenstein (LI)CHFEurope/Vaduz
Russia (RU)RUBEurope/Moscow
Svalbard & Jan Mayen (SJ)NOKArctic/Longyearbyen
Qatar (QA)QARAsia/Qatar
Kuwait (KW)KWDAsia/Kuwait
Bahrain (BH)BHDAsia/Bahrain
Oman (OM)OMRAsia/Muscat
Jordan (JO)JODAsia/Amman
Lebanon (LB)LBPAsia/Beirut
Syria (SY)SYPAsia/Damascus
Iraq (IQ)IQDAsia/Baghdad
Yemen (YE)YERAsia/Aden
Palestinian Territories (PS)ILSAsia/Hebron
Ghana (GH)GHSAfrica/Accra
Tanzania (TZ)TZSAfrica/Dar_es_Salaam
Uganda (UG)UGXAfrica/Kampala
Ethiopia (ET)ETBAfrica/Addis_Ababa
Rwanda (RW)RWFAfrica/Kigali
Côte d’Ivoire (CI)XOFAfrica/Abidjan
Senegal (SN)XOFAfrica/Dakar
Cameroon (CM)XAFAfrica/Douala
Zambia (ZM)ZMWAfrica/Lusaka
Mauritius (MU)MURIndian/Mauritius
Tunisia (TN)TNDAfrica/Tunis
Algeria (DZ)DZDAfrica/Algiers
Botswana (BW)BWPAfrica/Gaborone
Namibia (NA)NADAfrica/Windhoek
Mozambique (MZ)MZNAfrica/Maputo
Angola (AO)AOAAfrica/Luanda
Ascension Island (AC)SHPAtlantic/St_Helena
Burkina Faso (BF)XOFAfrica/Ouagadougou
Burundi (BI)BIFAfrica/Bujumbura
Benin (BJ)XOFAfrica/Porto-Novo
Congo - Kinshasa (CD)CDFAfrica/Kinshasa
Central African Republic (CF)XAFAfrica/Bangui
Congo - Brazzaville (CG)XAFAfrica/Brazzaville
Cape Verde (CV)CVEAtlantic/Cape_Verde
Djibouti (DJ)DJFAfrica/Djibouti
Western Sahara (EH)MADAfrica/El_Aaiun
Eritrea (ER)ERNAfrica/Asmara
Gabon (GA)XAFAfrica/Libreville
Gambia (GM)GMDAfrica/Banjul
Guinea (GN)GNFAfrica/Conakry
Equatorial Guinea (GQ)XAFAfrica/Malabo
Guinea-Bissau (GW)XOFAfrica/Bissau
Comoros (KM)KMFIndian/Comoro
Liberia (LR)LRDAfrica/Monrovia
Lesotho (LS)LSLAfrica/Maseru
Libya (LY)LYDAfrica/Tripoli
Madagascar (MG)MGAIndian/Antananarivo
Mali (ML)XOFAfrica/Bamako
Mauritania (MR)MRUAfrica/Nouakchott
Malawi (MW)MWKAfrica/Blantyre
Niger (NE)XOFAfrica/Niamey
Réunion (RE)EURIndian/Reunion
Seychelles (SC)SCRIndian/Mahe
Sudan (SD)SDGAfrica/Khartoum
St. Helena (SH)SHPAtlantic/St_Helena
Sierra Leone (SL)SLEAfrica/Freetown
Somalia (SO)SOSAfrica/Mogadishu
South Sudan (SS)SSPAfrica/Juba
São Tomé & Príncipe (ST)STNAfrica/Sao_Tome
Eswatini (SZ)SZLAfrica/Mbabane
Tristan da Cunha (TA)GBPAtlantic/St_Helena
Chad (TD)XAFAfrica/Ndjamena
Togo (TG)XOFAfrica/Lome
Mayotte (YT)EURIndian/Mayotte
Zimbabwe (ZW)USDAfrica/Harare
Kazakhstan (KZ)KZTAsia/Almaty
Uzbekistan (UZ)UZSAsia/Tashkent
Mongolia (MN)MNTAsia/Ulaanbaatar
Myanmar (Burma) (MM)MMKAsia/Yangon
Cambodia (KH)KHRAsia/Phnom_Penh
Laos (LA)LAKAsia/Vientiane
Brunei (BN)BNDAsia/Brunei
Macao SAR China (MO)MOPAsia/Macau
Maldives (MV)MVRIndian/Maldives
Bhutan (BT)BTNAsia/Thimphu
Afghanistan (AF)AFNAsia/Kabul
Cocos (Keeling) Islands (CC)AUDIndian/Cocos
Christmas Island (CX)AUDIndian/Christmas
British Indian Ocean Territory (IO)USDIndian/Chagos
Kyrgyzstan (KG)KGSAsia/Bishkek
North Korea (KP)KPWAsia/Pyongyang
Tajikistan (TJ)TJSAsia/Dushanbe
Timor-Leste (TL)USDAsia/Dili
Turkmenistan (TM)TMTAsia/Ashgabat
Guatemala (GT)GTQAmerica/Guatemala
Costa Rica (CR)CRCAmerica/Costa_Rica
Panama (PA)PABAmerica/Panama
Dominican Republic (DO)DOPAmerica/Santo_Domingo
Honduras (HN)HNLAmerica/Tegucigalpa
El Salvador (SV)USDAmerica/El_Salvador
Nicaragua (NI)NIOAmerica/Managua
Belize (BZ)BZDAmerica/Belize
Jamaica (JM)JMDAmerica/Jamaica
Trinidad & Tobago (TT)TTDAmerica/Port_of_Spain
Bahamas (BS)BSDAmerica/Nassau
Barbados (BB)BBDAmerica/Barbados
Haiti (HT)HTGAmerica/Port-au-Prince
Bolivia (BO)BOBAmerica/La_Paz
Ecuador (EC)USDAmerica/Guayaquil
Colombia (CO)COPAmerica/Bogota
Peru (PE)PENAmerica/Lima
Venezuela (VE)VESAmerica/Caracas
Antigua & Barbuda (AG)XCDAmerica/Antigua
Anguilla (AI)XCDAmerica/Anguilla
Aruba (AW)AWGAmerica/Aruba
St. Barthélemy (BL)EURAmerica/St_Barthelemy
Bermuda (BM)BMDAtlantic/Bermuda
Caribbean Netherlands (BQ)USDAmerica/Kralendijk
Cuba (CU)CUPAmerica/Havana
Curaçao (CW)XCGAmerica/Curacao
Dominica (DM)XCDAmerica/Dominica
Falkland Islands (FK)FKPAtlantic/Stanley
Grenada (GD)XCDAmerica/Grenada
French Guiana (GF)EURAmerica/Cayenne
Greenland (GL)DKKAmerica/Nuuk
Guadeloupe (GP)EURAmerica/Guadeloupe
Guyana (GY)GYDAmerica/Guyana
St. Kitts & Nevis (KN)XCDAmerica/St_Kitts
Cayman Islands (KY)KYDAmerica/Cayman
St. Lucia (LC)XCDAmerica/St_Lucia
St. Martin (MF)EURAmerica/Marigot
Martinique (MQ)EURAmerica/Martinique
Montserrat (MS)XCDAmerica/Montserrat
St. Pierre & Miquelon (PM)EURAmerica/Miquelon
Puerto Rico (PR)USDAmerica/Puerto_Rico
Suriname (SR)SRDAmerica/Paramaribo
Sint Maarten (SX)XCGAmerica/Lower_Princes
Turks & Caicos Islands (TC)USDAmerica/Grand_Turk
St. Vincent & Grenadines (VC)XCDAmerica/St_Vincent
British Virgin Islands (VG)USDAmerica/Tortola
U.S. Virgin Islands (VI)USDAmerica/St_Thomas
Fiji (FJ)FJDPacific/Fiji
Papua New Guinea (PG)PGKPacific/Port_Moresby
American Samoa (AS)USDPacific/Pago_Pago
Cook Islands (CK)NZDPacific/Rarotonga
Micronesia (FM)USDPacific/Pohnpei
Guam (GU)USDPacific/Guam
Kiribati (KI)AUDPacific/Tarawa
Marshall Islands (MH)USDPacific/Majuro
Northern Mariana Islands (MP)USDPacific/Saipan
New Caledonia (NC)XPFPacific/Noumea
Norfolk Island (NF)AUDPacific/Norfolk
Nauru (NR)AUDPacific/Nauru
Niue (NU)NZDPacific/Niue
French Polynesia (PF)XPFPacific/Tahiti
Palau (PW)USDPacific/Palau
Solomon Islands (SB)SBDPacific/Guadalcanal
Tokelau (TK)NZDPacific/Fakaofo
Tonga (TO)TOPPacific/Tongatapu
Tuvalu (TV)AUDPacific/Funafuti
Vanuatu (VU)VUVPacific/Efate
Wallis & Futuna (WF)XPFPacific/Wallis
Samoa (WS)WSTPacific/Apia

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.

Contributors and coding agents can optionally use the repository's local indexed code-search workflow to retrieve focused passages from unfamiliar subsystems without loading large files into an agent context.

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

License

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