Zenthory - Personal Finance Flutter App

Zenthory is a modern personal finance management application built with Flutter for Android and iOS. It is designed to help users organize and monitor their financial activity through a clean, intuitive, and easy-to-use mobile experience. The application provides a complete foundation for managing personal finances while maintaining fast performance and full offline access. Financial data is stored locally using Drift and SQLite, allowing the application to operate without requiring a backend server for its core functionality. Zenthory follows a modular Flutter architecture and uses Flutter Bloc for state management, making the source code easier to understand, customize, maintain, and extend. It is suitable for developers who want to create their own branded personal finance, expense tracking, budgeting, or money management application without starting from scratch. The project supports both Android and iOS and includes comprehensive documentation to simplify installation, configuration, customization, and development. Zenthory is a practical solution for developers, startups, and businesses looking for a ready-made Flutter foundation for building a modern and customizable personal finance application.

Features

• Personal finance dashboard with balance, income, expenses, weekly summary, and recent transactions.
• Income, expense, and debt transaction management.
• Create, edit, and delete transactions.
• Filter transactions by type, category, wallet, and date range.
• Multiple wallet management.
• Support for different wallet types and currencies.
• Add and withdraw wallet balances.
• Lock and unlock wallets.
• Hide wallet balances from the home screen.
• Automatic transaction creation when wallet balances change.
• Custom budget creation and management.
• Budget tracking by category and wallet.
• Visual spending progress indicators.
• Custom budget date ranges.
• Advanced financial reports and analytics.
• Net balance, total income, and total expense summaries.
• Monthly income vs. expense charts.
• Debt overview.
• Top income and expense categories.
• Report filtering by type, category, wallet, and date range.
• Categories and nested subcategories.
• Custom category icons and colors.
• Separate categories for income, expenses, and debts.
• Custom transaction tags for better organization and filtering.
• Contact management for lenders, borrowers, vendors, and other related entities.
• Multi-currency support.
• Default currency configuration.
• Manual and automatic exchange rate management.
• Unified balance calculations across multiple currencies.
• Biometric and PIN app protection.
• Screenshot control for enhanced privacy.
• Light and dark themes.
• Multi-language support.
• Fully offline operation using Drift and SQLite.
• Flutter Bloc state management.
• Clean and modular Flutter architecture.
• Android and iOS support.

Requirements

• Flutter SDK 3.7.2
• Dart SDK included with Flutter
• Android Studio for Android development and builds
• Android SDK
• Android Emulator or a physical Android device
• Xcode for iOS development and builds on macOS
• iOS Simulator or a physical iOS device
• VS Code or IntelliJ IDEA (optional)
• Flutter and Dart IDE extensions are recommended
• macOS is required for building the iOS version

Run flutter doctor after installing the required development tools to verify that the environment is configured correctly. After setup, install the project dependencies using flutter pub get and run the application using flutter run.

Instructions

1. Install Flutter SDK 3.7.2 on your development machine.
2. Install the required platform development tools:
   • Android Studio with Android SDK for Android development.
   • Xcode for iOS development on macOS.
   • VS Code or IntelliJ IDEA can be used as optional code editors.
3. Verify your Flutter environment by running:

flutter doctor

Resolve any issues reported by Flutter Doctor before continuing.

1. Extract the downloaded Zenthory source code and open the project directory in your preferred IDE.
2. Install all Flutter dependencies:

flutter pub get

1. Connect a physical device or start an Android Emulator / iOS Simulator.
2. Run the application:

flutter run

1. After confirming that the application runs correctly, you can customize the project branding, application name, package identifier, colors, languages, currencies, and other settings according to your requirements.

For iOS development and builds, macOS with Xcode is required.