zakat-companion

byzho yan

You are a **senior Flutter engineer, product designer, UI/UX specialist, and software architect**. Build the complete, polished MVP of **Zakat Companion** from the provided **PRD, Persona, User Flow, System Architecture, and final Figma wireframes**. ### SOURCE OF TRUTH Treat the supplied documents and Figma designs as the **absolute source of truth**. **Do not redesign, invent, remove, merge, or simplify approved functionality.** First analyze all provided materials, then implement them faithfully. If requirements conflict, identify the conflict before making assumptions. ### PRODUCT Zakat Companion is a **privacy-first, local-first, offline-capable Zakat calculator and guidance app** for the **“Cautious Zakat Payer.”** The experience must feel: **Trustworthy • Calm • Premium • Simple • Clear • Guided • Transparent • Private** ### CORE FLOW Implement the complete approved journey: **Language → Privacy/Onboarding → Home → Asset Classification → Asset Inputs → Guidance → Review → Nisab → Calculation → Breakdown → Summary → Save / PDF / Reminder** Also implement: **History → View → Edit → Delete** **FAQ → Details** **Guidance → Details** **Settings → Language / Privacy** Every CTA and back-navigation path in Figma must work. ### REQUIRED CALCULATION Support all approved categories: * Cash & Savings * Gold & Silver * Investments * Business Assets * Receivables / Money Owed * Debts / Liabilities Use a **centralized deterministic calculation engine**, separate from UI. Standard Zakat calculation: **Net Zakatable Wealth × 2.5%** Show a clear breakdown of: **Assets → Deductions → Net Wealth → Zakat** Do not hard-code demo results. ### NISAB Implement a dedicated Nisab experience showing: **Nisab threshold + User wealth + Eligibility + Explanation** Nisab values must be designed so they can be **verified/updated**, rather than permanently relying on outdated hard-coded market values. ### PRIVACY — NON-NEGOTIABLE The app must work without an account and without a backend. * Guest access * Offline calculations * Local-only financial data * User-controlled saving * Save / Edit / Delete * Secure local storage * No cloud synchronization * No banking credentials, OTPs or unnecessary personal data * Never expose financial data through logs, analytics or telemetry Privacy must be **actually implemented**, not merely described in the UI. ### FEATURES Implement all approved Figma/PRD functionality including: **English + Urdu localization** **Input validation** **Review before calculation** **Local history** **PDF calculation summary** **Local yearly/Ramadan reminder** **FAQ & Zakat guidance** **Empty states & confirmations** **Offline persistence** ### UI/UX Follow the **final Figma designs extremely closely**. Preserve: * Layout * Typography * Spacing * Colors * Components * Icons * Navigation * Cards * Forms * Progress indicators * States Make the app feel **premium and production-quality**, while remaining simple for a non-technical user. Do not add unnecessary animations, clutter, dashboards, or complicated interactions. ### ARCHITECTURE Use maintainable Flutter architecture with clear separation of: **UI → State → Business Logic → Calculation Engine → Local Storage / Services** Use reusable widgets, models, services, localization and centralized calculation logic. Avoid both **giant files** and **unnecessary over-engineering**. ### DEVELOPMENT Work in phases: **1. Analyze → 2. Foundation → 3. UI/Navigation → 4. Calculation Flow → 5. Results → 6. Local Storage → 7. PDF/Reminder/FAQ → 8. QA** After every phase: **Run → Test → Fix → Verify → Continue** Do not knowingly move forward with broken builds, navigation or functionality. ### FINAL QA Before completion verify: * All Figma screens implemented * Complete user flow works * Calculations are correct * Nisab works * Validation works * Save/Edit/Delete works * History persists after restart * PDF works * Reminder works locally * English/Urdu work * Offline functionality works * Privacy requirements are enforced * No backend/cloud storage exists * No unapproved features were added * UI matches the final Figma ### FINAL GOAL Build **Zakat Companion — not a generic Zakat calculator**. The final result must look and behave like a **real polished product ready for demonstration/submission**, faithfully implementing the approved PRD, Persona, User Flow, Architecture and Figma. **Analyze first. Build intelligently. Follow the source of truth. Test everything. Do not invent or redesign.**