Skip to content

Emon526/Expense-Planner

Repository files navigation

Expense Planner

License GitHub Issues GitHub Forks GitHub Stars Releases

Overview

Welcome to Expense Planner, a comprehensive Flutter application designed to assist users in effectively managing their expenses. This project utilizes Flutter for cross-platform compatibility, enabling seamless operation on both Android and iOS devices.

Table of Contents

Features

  • Data Persistence: Users can securely save their expense data locally for easy retrieval.
  • Multi-Duration Expense Visualization: Analyze expenses over various time frames, including the last 7 days, 15 days, and 30 days.
  • Transaction Management: Users have the flexibility to delete any expense transaction at their discretion.
  • Customizable Themes: Choose between light and dark themes to enhance user experience.

Packages Utilized

This project leverages the following packages:

  • flutter: The core Flutter SDK for building the application.
  • intl: A package for internationalization and localization.
  • sqflite: A SQLite plugin for local database storage.
  • cupertino_icons: Provides iOS-style icons for the application.
  • provider: A state management package that enhances the efficiency of app state handling.
  • shared_preferences: A package for storing simple data in key-value pairs.
  • flutter_native_splash: Facilitates the creation of native splash screens for the application.

Application Compatibility

This application is fully functional and compatible with both Android and iOS devices.

Installation Instructions

To set up the project, ensure you have Flutter installed on your machine. For detailed installation guidance, please refer to the official Flutter installation guide.

  1. Clone the repository:
    git clone https://github.com/Emon526/Expense-Planner.git
    cd Expense Planner
  2. Install the necessary dependencies:
    flutter pub get

Usage Instructions

To run the application, execute the following command:

flutter run

Application Demonstration

This demo highlights the key features of the Expense Planner application, including data entry, expense visualization, and theme selection.

App Demo

App Screenshots

Here are some screenshots showcasing the user interface of the Expense Planner application:

Home Screen

Dark Home Screen Light Home Screen

Input Screen

Dark Input Screen Light Input Screen

Data View Screen

Dark Data View Screen Light Data View Screen

Theme Selection

Dark Theme Selection Light Theme Selection

Landscape Main Screen

Dark Landscape Main Screen Light Landscape Main Screen

Landscape Chart View Screen

Dark Landscape Chart View Light Landscape Chart View

Troubleshooting

If you encounter issues while using the application, consider the following solutions:

  • Common Issues:
    • If the app crashes on startup, ensure all dependencies are correctly installed and up to date.
    • If you experience issues with the database, try running flutter clean and then flutter pub get.

Contribution Guidelines

We welcome contributions! If you wish to contribute to the Expense Planner project, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Implement your changes and commit them.
  4. Push your changes to your forked repository.
  5. Submit a pull request detailing your modifications.

Contact Information

For any inquiries or support, please reach out to developer.asrafulislam@gmail.com.