FinLog is a Flutter-based mobile application for personal finance management and expense tracking. It features AI-powered journaling using Gemini API, manual transaction logging, receipt scanning capabilities, and comprehensive data visualization.

• Manual Transaction Logging - Add income and expenses with custom categories
• AI-Powered Journaling - Natural language transaction entry via Gemini API
• Receipt Scanning - Extract transaction data from receipt images (Gemini API)
• Transaction History - View and manage all your financial records
• Smart Categorization - Automatic expense categorization
• AI Insights - Get intelligent financial insights and recommendations Coming soon
• Data Visualization - Charts and graphs for spending analysis
• User Profile Management - Customizable profiles with API key configuration
• Local Storage - Secure offline data storage with Hive

• Framework: Flutter
• State Management: Provider
• Local Database: Hive
• AI Integration: Gemini API
• Environment Config: flutter_dotenv

📱 Download Latest Version (v1.2.11+28)

• Flutter SDK installed and configured
• Gemini API Key from Google AI Studio
• Android Studio, VS Code, or preferred IDE
• Physical device or emulator for testing

1. Clone and Setup

   git clone https://github.com/Apps-FinLog/FinLog.git
   cd FinLog
   flutter pub get

2. Environment Configuration

   Create a .env file in the project root:

   GEMINI_API_KEY=your_actual_api_key_here

   ⚠️ Security: Never commit your .env file. Ensure it's in .gitignore.

3. Verify Setup

   flutter doctor

4. Run the App

   flutter run

Android APK:

flutter build apk --release

Output: build/app/outputs/flutter-apk/app-release.apk

App Bundle (Play Store):

flutter build appbundle

Configure your Gemini API key in one of two ways:

1. Environment file (recommended for development) - Add to .env file
2. In-app setup - Configure in the app's profile section after first launch

# Hot reload development
flutter run

# Clean build
flutter clean && flutter pub get

# Run tests
flutter test

# Code analysis
flutter analyze

• Release Build API Calls: Gemini API may not function in release builds due to configuration or Proguard/R8 settings
• Development Hot Restart: Fresh installs may require hot restart (R) for Gemini API features to initialize properly

• API key configuration for release builds
• Service initialization timing issues
• API key restrictions in production environments

These issues are actively being addressed. Features relying on Gemini API may be affected.

Flutter not recognized:

flutter doctor

API Key errors:

• Verify API key in .env file
• Check permissions in Google AI Studio
• Ensure key hasn't expired

Build failures:

flutter clean
flutter pub get
flutter build apk --release

FinLog/
├── .env                 # Environment variables (not tracked)
├── lib/                 # Main application code
├── android/             # Android configuration
├── ios/                 # iOS configuration
├── build/               # Build outputs
└── pubspec.yaml         # Dependencies

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

This project is licensed under the MIT License - see the LICENSE for details.