dmuhoro/Daftari

Offline-first BusinessOS for Kenyan informal vendors. Profit visibility in Kiswahili and English. # Daftari — Business Ledger for Kenyan SMEs Offline-first PWA for Kenyan small businesses. Track sales, expenses, M-Pesa payments, inventory, and customers — all without a constant internet connection. Built with React, TypeScript, Vite, Supabase, and Dexie.js. ## Features - **M-Pesa SMS Parsing** — Paste any M-Pesa message and auto-fill the amount, sender, and payment method - **Offline-First** — All data stored locally in IndexedDB, syncs to cloud when online - **Receipts** — Auto-generated receipt IDs for every sale (e.g. `REC-250719-0001`) - **WhatsApp Sharing** — Share receipts and daily summaries directly to WhatsApp - **Customer Intelligence** — Automatic customer tracking from M-Pesa senders - **Inventory Management** — Track stock levels with low-stock alerts and restock functionality - **Bilingual** — Full Kiswahili and English support - **Dark Mode** — Light, dark, and system-follow themes - **Fuliza Tracking** — Track Fuliza debt against daily revenue - **Daily Close** — Automated end-of-day prompts with profit summary - **PWA** — Install on your phone's home screen for app-like experience - **Error Tracking** — Sentry integration with production error capture - **Analytics** — Privacy-first event analytics via Supabase (no third-party trackers) - **Digital Receipts** — Auto-generated receipt numbers (`REC-YYMMDD-XXXX`) for every sale ## Tech Stack | Layer | Technology | |-------|-----------| | Frontend | React 18, TypeScript, Vite 5, TailwindCSS | | State | Zustand (persisted to localStorage) | | Offline DB | Dexie.js (IndexedDB) | | Backend | Supabase (Postgres, Auth, Storage) | | Charts | Recharts | | Error Tracking | Sentry | | Analytics | Supabase (self-hosted) | | PWA | vite-plugin-pwa, Workbox | | Testing | Vitest, React Testing Library | | CI/CD | GitHub Actions → Vercel | ## Quick Start ```bash npm install npm run dev ``` Open `localhost` in your browser. ## Available Scripts | Command | Description | |---------|---------- …