Inventory Platform — Storekeeper Mobile App (Flutter)

A mobile / tablet app designed for:

• Central storekeepers
• Site-level storekeepers

The app enables fast day-to-day inventory operations.

---

🧩 Part of the Centralized Inventory Platform

• Platform Overview
  👉 https://github.com/Whoolab-Technologies/multistore-inventory-platform
• Shared Mobile Components
  👉 https://github.com/Whoolab-Technologies/inventory-flutter-common
• API Server
  👉 https://github.com/Whoolab-Technologies/inventory-api
• Admin Web App
  👉 https://github.com/Whoolab-Technologies/inventory-admin-web
• Engineer App
  👉 https://github.com/Whoolab-Technologies/inventory-engineer-flutter

---

✨ Storekeeper Features

• View store-level stock
• Scan QR codes to locate items
• Process MR raised by engineers
• Fulfill transfers from central / other stores
• Handle PR-linked issue workflows
• Track material transfer statuses
• Receive returned materials from engineers
• Return materials to central store
• View store-specific reports

---

🛠️ Tech

• Flutter
• Shared Component Library

---

🚀 Local Setup

1. Clone the Project

git clone https://github.com/Whoolab-Technologies/inventory-storekeeper-flutter
cd inventory-storekeeper-flutter

Note: This project depends on mvp_shared_components. Ensure the shared repository is cloned in the sibling directory:

cd ..
git clone https://github.com/Whoolab-Technologies/inventory-flutter-common.git
cd inventory-storekeeper-flutter

2. Flutter Environment

This project uses Flutter 3.24.5 (defined in .fvmrc).

It is recommended to use FVM to manage the version:

fvm install
fvm use

3. Install Dependencies

fvm flutter pub get

4. Code Generation

Run build_runner to generate code for JSON serialization, Freezed, and dependency injection:

dart run build_runner watch --use-polling-watcher --delete-conflicting-outputs

5. Firebase Setup

This project uses Firebase. You need to configure it for your environment.

1. Install the FlutterFire CLI.
2. Login to Firebase: firebase login
3. Configure the project:

flutterfire configure

Select your Firebase project and the platforms (Android, iOS) to generate firebase_options.dart.

6. Build Android App

To build a release APK or App Bundle, you need to configure the signing keys.

1. Create a file named key.properties in the android/ directory.
2. Add your keystore details to android/key.properties:

storePassword=<your_store_password>
keyPassword=<your_key_password>
keyAlias=<your_key_alias>
storeFile=<path_to_your_keystore.jks>

3. Build the APK or App Bundle:

# Build APK
fvm flutter build apk --release

# Build App Bundle
fvm flutter build appbundle --release

---

🏷️ License

This project is open-source for learning and evaluation purposes.

❗ Commercial use, resale, hosting as a service, or redistribution is not permitted.

For commercial licensing, customization, or deployment:

📩 mail@whoolab.com

---

💼 Enterprise Deployments

We can help with:

• Organization onboarding
• Custom workflows
• Field-operations optimizations

📩 mail@whoolab.com