The consumer-facing mobile application for the Fidelity Ecosystem—a shared loyalty points network designed for small business networks. Built with Flutter, this app allows end-users to earn, track, and redeem loyalty points across all participating partner stores.
The overall multi-tier system coordinates across consumer, merchant, and core backend components:
| Component | Repository | Tech Stack | Audience & Function |
|---|---|---|---|
| B2C Mobile App | This Repo | Flutter, Dart | Consumer mobile app for end-users to collect & redeem points |
| Full-Stack Core | Fidelity-Web-Server | Node.js, Express, MySQL | Core REST API backend & management web portal |
| B2B Merchant App | Fidelity-Corp | Angular / Android | Merchant application for store owners to manage rules & scan points |
- 📱 Cross-Platform Support: Native performance across Android and iOS platforms.
- 🔐 Member Authentication: Secure client registration, phone/SMS validation, and profile management.
- 💳 Real-time Point Tracking: Live balance visibility and unified loyalty point ledger.
- 🏪 Partner Store Directory: Browse nearby participating merchants, store locations, and special rewards.
- 📜 Transaction History: Detailed activity log showing earned, transferred, and redeemed points.
- ⚡ REST API Integration: Direct asynchronous communication with the central server API.
Fidelity-App/
├── android/ # Native Android configuration & wrappers
├── ios/ # Native iOS configuration & wrappers
├── lib/ # Core Flutter/Dart application code
│ ├── screens/ # Application screens (Home, Profile, Catalog)
│ ├── widgets/ # Reusable UI components & custom controls
│ ├── services/ # REST API requests, storage, & state handlers
│ └── main.dart # Application entry point
├── pubspec.yaml # App metadata, assets, & dependencies
└── README.md # Documentation
- Flutter SDK (
v3.xrecommended) - Dart SDK (bundled with Flutter)
- Android Studio / Xcode for virtual emulators or physical testing
# Clone the repository
git clone [https://github.com/Sadoklaoo/Fidelity-App.git](https://github.com/Sadoklaoo/Fidelity-App.git)
cd Fidelity-App
# Fetch dependencies
flutter pub getConfigure backend connections before running:
# Example configuration (.env or service URL constant)
API_URL=[https://your-api-domain.com/api](https://your-api-domain.com/api)Run the App
# Run on default connected device/emulator
flutter run
# Target a specific device ID
flutter run -d <device_id>Contributions are welcome! Feel free to open an issue or submit a Pull Request.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.