ngenotm/chama-smart

Managing chamas in Kenya # ChamaSmart 🚀 A **Progressive Web App (PWA)** for managing Kenyan Investment Groups (Chamas), with comprehensive member management, savings tracking, table banking (loans), and investment portfolio management. ## ✨ Features ### 📱 Progressive Web App - **Installable** on desktop and mobile devices - **Offline Support** with intelligent caching - **Fast Loading** with service worker optimization - **App Shortcuts** for quick access to key features - **Native-like Experience** with standalone display mode ### 🔍 SEO Optimized - **Comprehensive Meta Tags** for better search rankings - **Structured Data (JSON-LD)** for rich search results - **Dynamic Sitemap** generation - **Open Graph** tags for social media sharing - **Twitter Cards** for enhanced Twitter previews - **Robots.txt** for proper search engine crawling ### 💼 Core Business Features 1. **Dashboard** - Real-time overview of group finances and activities 2. **Member Management** - Unified member list with role-specific views (Admins manage, Members view) 3. **Advanced Profile Settings** - Self-service profile updates with auto-formatting for names (Title Case) and Kenyan phone numbers (+254...) 4. **Cloud Branding** - Custom Chama logos and Profile Pictures via **UploadThing** 5. **Real-time Sync** - Instant session synchronization across sidebar, header, and components without page refreshes 6. **Transactions** - Complete ledger with M-Pesa integration support 7. **Table Banking** - Loan management with guarantor approval system 8. **Investment Tracking** - Portfolio management with valuation tracking 9. **Financial Reports** - Automated reporting and analytics ## 🛠️ Tech Stack - **Framework:** Next.js 16.1.5 (App Router, Turbopack) - **Language:** TypeScript 5 - **Cloud Storage:** **UploadThing** (for all images/branding) - **Styling:** Tailwind CSS v4 - **UI Components:** Shadcn/ui (Radix UI) + Lucide React icons - **Database:** Neon Postgres (Serverless) - **Auth:** NextAuth.js v5 - **ORM:** Pri …