Wasaanyi/bigtal

A desktop application for small shops in Uganda and Africa. Wave Accounting-inspired simplicity. # Bigtal - Small Business Management #### Video Demo: youtu.be #### Description: A desktop application for small shops in Uganda and Africa. Wave Accounting-inspired simplicity with max 3 clicks for main actions. ## Tech Stack - **Framework**: Electron 28+ - **Frontend**: React 18 + TypeScript - **Styling**: Tailwind CSS 3 - **Database**: PGlite (PostgreSQL-compatible, offline-first) - **State**: Zustand - **Routing**: react-router-dom 6 - **Build**: Vite + electron-builder ## Getting Started ### Prerequisites - Node.js 18+ - npm or yarn ### Installation ```bash # Install dependencies npm install # Run in development mode npm run dev ``` ### Default Login Credentials - **Admin**: username: `admin`, password: `admin` - **Attendant**: username: `attendant`, password: `1234` ## Building for Production ```bash # Build for current platform npm run package # Build for specific platforms npm run package:win # Windows npm run package:mac # macOS npm run package:linux # Linux ``` ## Features ### Core Features - **Dashboard**: Quick overview with today's income, expenses, cash balance, and top products - **Invoices**: Create, manage, print, and track invoices with status filtering - **Products**: Inventory management with categories, stock tracking, and supplier linking - **Expenses**: Record and categorize business expenses with supplier association - **Customers & Suppliers**: Contact management with soft-delete support - **Multi-currency**: Support for UGX, KES, TZS, ZAR, USD, NGN, GHS, RWF ### Business Settings - Configure business name, address, phone, and email - Upload business logo for invoice branding - Business info appears on printed invoices ### Invoice Printing - Professional invoice layout with business branding - Customizable header with business logo and contact info - "Generated by Bigtal" footer branding - Print directly or save as PDF ### Email Integration - SMTP configuration for sending invoices - Support fo …