HowMuch is a sleek, minimalist personal finance tracker built with Flutter. It helps users visualize their savings goals, manage their balance, and track their progress with a focus on privacy and clean design.
- Secure Access: A 4-digit numeric passcode lock screen that enforces digits-only input to protect financial data.
- Customizable UI: Full support for Light Mode and a custom Deep Dark Mode for readability.
- Personalization: Users can set their display name and upload a profile picture at any time.
- Modern Typography: Integrated with Google Fonts for a clean aesthetic.
- Cross-Platform: Designed to run smoothly on Android and iOS.
- Persistent Storage: Saves user preferences, balance, and security settings locally so data is never lost on restart.
- Framework: Flutter
- Language: Dart
- State Management:
ValueListenableBuilder(for reactive theme switching). - Key Packages:
google_fonts: For global font styling.shared_preferences: To handle local data persistence.image_picker: For profile photo selection.services: For strict input formatting.
| Timeline/Goal Page | Home Screen | Settings Page | Invite Card | Passcode Lock |
|---|---|---|---|---|
 |
 |
 |
 |
 |
- Flutter SDK (3.x or higher)
- Dart SDK
- An IDE (VS Code or Android Studio)
-
Clone the repository:
git clone https://github.com/tarikcolic/howmuch-app.git cd howmuch-app -
Install dependencies:
flutter pub get
-
Run the app: For Windows Desktop (ensure you run as Administrator for symlink support):
flutter run -d windows
For Android/iOS:
flutter run
This app prioritizes user privacy by storing all data locally on the device.
- Input Enforcement: All passcode fields utilize
FilteringTextInputFormatter.digitsOnlyto prevent accidental lockout through non-numeric characters. - Access Control: The app triggers a lock screen overlay on startup if a passcode is set.
Distributed under the MIT License.