zxds1/uza_pos

A modern offline-first Flutter POS system for small retailers in Kenya. Process sales, manage inventory, and sync data seamlessly with or without internet connectivity # UZA POS **Offline-first POS system for Kenyan dukas** — a modern, mobile-optimized point-of-sale application built with Flutter that enables small retailers to manage sales, inventory, and customers even without internet connectivity. ## 🎯 Features - **Offline-First Architecture** — Full POS functionality works seamlessly without internet connection - **Inventory Management** — Track products, stock levels, and categories - **Customer Management** — Build customer profiles and transaction history - **Sales & Transactions** — Process sales, handle multiple payment methods - **Barcode Scanning** — QR/barcode scanning via mobile camera - **OCR Support** — Google ML Kit text recognition for receipt OCR - **Multi-shop Support** — Manage multiple locations/dukas - **Data Export** — Export sales data in CSV and Excel formats - **Local Authentication** — Biometric and PIN-based security - **Sync Capabilities** — Synchronize data when connection is available via Dio HTTP client - **Demo Mode** — Pre-loaded demo data for testing and training ## 🛠️ Tech Stack - **Framework:** Flutter (Dart) - **State Management:** Riverpod with annotations - **Local Storage:** Hive database for offline-first persistence - **Networking:** Dio for HTTP requests with offline support - **Connectivity:** Connectivity Plus for network state monitoring - **UI:** Material Design with Flutter SVG, Google Fonts, Shimmer effects - **Maps:** Google Maps Flutter integration - **Forms:** Flutter Form Builder with validation - **Analytics & Tracking:** Device info, package info, UUID generation - **Background Tasks:** WorkManager and Flutter Background Service - **Security:** Flutter Secure Storage, Local Auth (biometric), Crypto ## 📱 Platform Support - **Minimum SDK:** Dart 3.0.0+ - **Primary Target:** Android (ideal for budget smartphones common in Kenya) ## 📋 Requirements - Flutter SDK (>=3.0.0) - Dart 3.0.0+ - Android SDK / iOS SDK (if targeting both platforms) ## 🚀 Getting Started ### Insta …