HandyShopper

HandyShopper is a mobile application designed to help you keep track of your shopping needs in a simple and pragmatic way.

Features

• Track Products: Keep a list of products, quantities, and prices.
• Categorize Needs: Easily mark products as needed and view them separately.
• Sort and Reorder: Sort products by name, quantity, or price, and manually reorder your list.
• Currency Selection: Choose your preferred currency for product prices.
• Dark Mode Support: Automatically adapts to your device's theme.
• Multi-Language Support: Switch between multiple languages.

Screenshots

Localizations

• English (en)
• Bengali (bn)
• German (de)
• Spanish (es)
• Persian (fa)
• French (fr)
• Hindi (hi)
• Italian (it)
• Japanese (ja)
• Korean (ko)
• Marathi (mr)
• Punjabi (pa)
• Portuguese (pt)
• Russian (ru)
• Tamil (ta)
• Telugu (te)
• Turkish (tr)
• Urdu (ur)
• Vietnamese (vi)
• Chinese (zh)

Getting Started

Prerequisites

• Flutter SDK
• Dart SDK

Play Store signing

The Android build is signed with a key defined in "android/key.properties" with the following syntax:

storePassword=MyStorePassw0rd keyPassword=MyKeyPassw0rd keyAlias=play-store_release storeFile=play-store_release-key.keystore

The actual key file needs to be placed at "android/app/play-store_release-key.keystore".

Installation

1. Clone the repository:

   git clone https://github.com/LuminaAppsDev/handyshopper.git
   cd handyshopper
   
   

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

Usage

• Adding Products: Tap the "+" button at the bottom left corner to add a new product.
• Editing Products: Tap on a product in the list to edit its details.
• Deleting Products: Tap the trash icon on a product to delete it, with a confirmation dialog.
• Sorting Products: Tap the sort icon at the bottom right corner to open sorting options.
• Manual Reordering: Long-press on a product and drag to reorder it.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request for any features or bug fixes.

License

This project is licensed under the Zero-Clause BSD License - see the LICENSE file for details.

Acknowledgements

• Flutter
• Provider Package
• Sqflite Package
• Shared Preferences Package