Inventory Platform — Shared Flutter Components

Reusable Flutter widgets, utilities, and UI components shared across:

• Storekeeper Mobile App
• Engineer Mobile App

This library ensures a consistent design system, shared business UI patterns, and reduces duplicated code across mobile modules.

---

🧩 Part of the Centralized Inventory Platform

This repository is one of the core modules of the multi-store inventory system:

• Platform Overview
  👉 https://github.com/Whoolab-Technologies/inventory-platform
• API Server
  👉 https://github.com/Whoolab-Technologies/inventory-api
• Admin Web App
  👉 https://github.com/Whoolab-Technologies/inventory-admin-web
• Storekeeper App
  👉 https://github.com/Whoolab-Technologies/inventory-storekeeper-flutter
• Engineer App
  👉 https://github.com/Whoolab-Technologies/inventory-engineer-flutter

---

✨ What this package includes

• Shared UI components
• Common form builders
• Reusable layout widgets
• Core theme & design tokens
• Common services & helpers
• Shared QR-scanner UI hooks
• Common navigation patterns

---

🎯 Why a shared library?

• Prevents UI/logic duplication
• Keeps both apps visually consistent
• Enables faster feature updates
• Improves long-term maintainability

---

🛠️ Tech

• Flutter
• Dart
• Modular architecture

---

💻 Local Setup

1. Clone the repository

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

2. Setup Flutter environment

This project relies on FVM (Flutter Version Management) for version consistency. Refer to .fvmrc for the exact version (currently 3.24.5).

Using FVM:

fvm install
fvm use

Or ensure your global Flutter version matches the one in .fvmrc.

3. Install dependencies

fvm flutter pub get
# or
flutter pub get

---

🏷️ 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

---

🤝 Contributions

Internal enhancement contributions are welcome.

---

💼 Business / Customization Enquiries

This library is part of a complete enterprise inventory platform.

If your organization needs:

✔️ Feature customization
✔️ Custom workflows
✔️ Mobile app extensions

📩 Contact Whoolab Technologies
📧 mail@whoolab.com