ZeroG ⚡

ZeroG is a premium, high-contrast, editorial-style personal finance ledger and peer-to-peer debt tracker built with Flutter. Designed around a strict monochromatic/dark aesthetic, ZeroG treats your financial transaction logs with cinematic minimalism while providing modern features like local database management, custom data visualization, and an AI-powered financial advisor.

---

🎨 Design Philosophy

• Cinematic Minimalism: Built on a solid pure black background (#000000) with high-contrast bold white elements.
• Heavy Typography: Styled after physical editorial layouts, using heavy font weights, tight letter spacing, and clean layouts.
• Geometric Visualization: Visual stats represented with strict greyscale line and circular charts to focus entirely on transaction patterns.

---

✨ Features

1. Unified 5-Tab Navigation Wrapper

• Dashboard (Home): Shows your total spending, amounts owed/pending, a custom-designed greyscale pie/donut chart detailing spending categories, and a summary of your latest transactions.
• Transactions Log: A complete reverse-chronological ledger of all entries with swipe-to-delete dismissible actions and complete undo support.
• Geometric Analytics Suite:
  • Pie Chart: Interactive personal category spending breakdown.
  • Bar Chart: Minimalist slim-rod 6-month historical spending trend.
  • Scatter Plot: Bubble chart mapping day of the month vs. transaction value to highlight density of transaction frequency.
• Network (P2P Debt Tracker):
  • A real-time list of all contacts you have lent to or borrowed from.
  • Hides inactive (zero balance) contacts automatically.
  • Color-coded indicator (+ green for money owed to you, - red for money you owe).
  • Timelines showing detailed history of cash exchanges with each specific person.
• Settings: A clean options layout for triggerable CSV exports of the entire transaction database.

2. RAG AI Financial Advisor

• An integrated, interactive chat client powered by Nvidia's Llama 3 model.
• Utilizes a custom token compression algorithm that strips and compacts local Hive transaction data into lightweight JSON keys, optimizing context token usage.
• Gives you direct financial summaries, trends analysis, and budgeting advice based on your real transactions.

3. Native Integration & Assets

• Custom Adaptive Launcher Icons: Specifically styled monochrome, adaptive, and legacy app icons.
• Native Splash Screen: Seamless, non-stretching white transparent logo centered on a pure black background matching light/dark configurations.
• CSV Data Portability: Instant database backup that converts Hive records to raw CSV tables and calls native device share sheets.

---

🛠️ Technical Stack

• Framework: Flutter (Dart)
• Local Database: Hive CE (Community Edition) with automated type adapters.
• Visualizations: fl_chart
• API Communications: http & flutter_dotenv for configuration.
• Data Exports: csv & share_plus

---

🚀 Getting Started

Prerequisites

Make sure you have the Flutter SDK installed on your machine.

Installation

1. Clone the repository:

   git clone https://github.com/LikhinMN/ZeroG.git
   cd zerog

2. Set up environment variables: Create a .env file at the root of the project:

   NVIDIA_API_KEY=your_nvidia_llama_api_key_here

3. Install dependencies:

   flutter pub get

4. Run build runner (to generate Hive adapter configurations if needed):

   flutter pub run build_runner build --delete-conflicting-outputs

5. Launch the application:

   flutter run

---

📱 Release & Native Assets

To update the splash screen assets natively:

flutter pub run flutter_native_splash:create

Note: Launcher icons have been configured as custom native resources in android/app/src/main/res/ to preserve exact designs and avoid package overrides.