A robust, offline-first mobile ERP engineered with Flutter and Hive NoSQL for ice cream distributors, wholesalers, and supply chain merchants. Manage product catalogs, profit margins, client ledgers, advance orders, operational expenses, cash flow, and export itemized PDF reports.
Overview β’ Visual Showcase β’ Core Modules β’ Tech Stack β’ Architecture β’ Getting Started β’ Author
Operating an ice cream distribution and wholesale supply chain requires balancing high inventory turnover, cold-chain operational expenses, advance pre-orders, dual-entry client credit balances ("You'll Get" / "You'll Give"), and multi-channel payment reconciliation (Cash, PhonePe, GPay).
Creamventory is designed as a standalone, offline-first command center. Built with Flutter and persistent Hive NoSQL storage, the app eliminates dependence on continuous internet connectivityβempowering distributors to perform real-time stock adjustments, bill clients, log van fuel expenses, and generate professional PDF statements on the go with zero latency.
Get an instant overview of your business health. The Command Center provides real-time snapshots of your total product count, low-stock alerts, and today's vital sales and order metrics.
- Real-Time KPI Cards: Instant metrics for Total Products, Low Stocks, Today's Orders, and Today's Sales.
- Quick-Access Launchpad: Direct links to create new sale orders or access client distribution records.
- Slide Navigation Drawer: Centralized navigation across inventory, transactions, expenses, reports, and settings.
Your central Stock Master for real-time inventory tracking. Monitor total product counts, current stock levels, and pricing for every ice cream item in your warehouse. Monitor individual item performance with a complete sales and restock adjustment ledger.
- Stock Master: Detailed item cards with stock counts, sale prices, purchase prices, and total holding stock valuation.
- Granular Stock History: Complete audit trail logging every restock event (+items) and sale deduction (-items).
- In-App Stock Adjustments: Rapid stock correction button to update inventory counts on demand.
Browse and organize your full range of ice cream offerings by types like Cones, Sundaes, and Syrups. View a detailed overview of a specific product category, including description, total item count, stock levels, and profit margins.
- Categorized Inventory: Group products into intuitive lines (Bars, Tubs, Cones, Syrups, Sundaes, Frozen treats).
- Profit Margin Calculation: Real-time visibility into sale price vs. purchase cost with margin percentages (e.g.,
+βΉ90.00 (22%)). - Category Descriptions: Rich metadata explaining packaging sizes (e.g., 500ml vs 1L tubs) and product guidelines.
Track client balances, payments, and outstanding credit for every shop you supply. Detailed breakdown of sales, sales orders, and payment status for individual parties.
- Net Receivables & Payables: Real-time totals of outstanding client dues (You'll Get) and supplier liabilities (You'll Give).
- Party Profiles: Complete merchant cards with contact information (email, phone, address) and quick-search filters.
- Party Transaction Ledger: Filterable record of previous orders, current balance, and settlement states for each store.
Schedule future sales by logging pre-orders for specific due dates, ensuring your inventory is reserved and ready for delivery when the customer needs it. Manage your distribution workflow in one organized view.
- Advance Scheduling: Create pre-orders with auto-generated invoice IDs, customer dropdowns, and target delivery due dates.
- Itemized Cart Builder: Seamless item selection with quantity controls and real-time total calculation.
- Lifecycle Order Tracking: Filter orders cleanly across
All,Open orders,Closed orders, andCancelled orders.
Track your business spending with a complete history of operational costs, helping you monitor total expenses for categories like fuel and vehicle maintenance to keep your business spending organized and accurate.
- Multi-Category Expenses: Tag expenses to essential operational categories (Fuel/Petrol for delivery vans, Deep Freezer maintenance, Vehicle servicing, Daily logistics).
- Unit Rate & Quantity Calculator: Log rate and quantity (e.g., 10L petrol @ βΉ115/L) with automatic sum calculations.
- Expense Monitor: Monthly expense totals, entry counts, and date-filtered expense transaction history.
Manage and review all outgoing payments made to clients or suppliers, tracking total amounts paid and transaction methods like PhonePe, GPay, or Cash. Monitor all incoming payments from clients with detailed history.
- Payment-In (Collections): Log customer receivables with payment mode tags (PhonePe, Google Pay, Cash) and transaction reference IDs.
- Payment-Out (Payouts): Track settlements paid out to suppliers or return refunds.
- Monthly Summary Cards: Instant tallies for "No. of Payments" and "Total Payment In / Out".
Use interactive charts to monitor weekly or monthly trends in income, sales, and expenses. Generate itemized, professional PDF documents of sales and payments for record-keeping.
- Trend Analytics: Interactive line charts comparing performance curves (e.g., Current Week vs. Previous Week) across days of the week.
- Flexible Reporting: Switch between Income, Sales, Expense, and Payment reports with custom date pickers.
- Itemized PDF Documents: One-tap export to clean, printable PDF statements formatted with date, transaction type, reference ID, and grand totals.
This page provides a quick overview of your business profile, distribution company details, and a summary of your inventory's health. Update your password here to keep your business data and client information safe.
- Financial Health Summary: High-level overview of Total Income, Total Expenses, and Net Balance ("You Will Get" vs "You Will Give").
- Brand Profile: Custom company branding (e.g., Arctic Delight Ice Cream Supply) and support email.
- Security & Password Update: Password change flow with match validation and built-in security recommendations.
| Module | Core Functionality |
|---|---|
| π¦ Product & Vault | Real-time stock levels, purchase & sale prices, stock value computation, and itemized adjustment logs. |
| π·οΈ Catalog & Margins | Category segmentation, product descriptions, profit margin percentages, and bulk inventory views. |
| π€ Distribution & Parties | Client khata balance tracking ("You'll Get" / "You'll Give"), shop contact details, and client order histories. |
| π Sale Orders | Advance pre-order booking with delivery due dates, cart builder, and multi-state order status monitor. |
| β½ Expense Logger | Cold-chain logistics tracking, vehicle fuel, freezer repair costs, and category-wise spending summaries. |
| π³ Cash & Collections | Detailed Payment-In and Payment-Out logs with PhonePe, GPay, and Cash transaction tags. |
| π Analytics & PDF Export | Multi-week trend charts, custom date filters, and exportable, print-ready PDF statements. |
| β‘ Offline-First Storage | Lightning-fast Hive NoSQL storage with binary serialization β zero latency and full offline autonomy. |
- UI Framework: Flutter (Channel Stable, Material Design 3)
- Language: Dart
- Local Persistence: Hive & hive_flutter
- Backend & Cloud Services: Firebase (
firebase_options.dart) - Notifications: In-App & Local Push Notification Services
- Code Generation: build_runner & hive_generator
- PDF & Document Printing: pdf & printing
- Visualizations: Custom interactive trend & line charts
--
- Flutter SDK (
>= 3.0.0) - Dart SDK
- Android Studio / VS Code with Flutter extension
- An Android device, emulator, or iOS simulator
Creamventory adheres to a modular, feature-first clean architecture with dedicated separations between presentation views, domain utilities, and an offline-first NoSQL database layer.
graph TD
UI["π± Presentation Layer\n(Screens & Custom Widgets)"]
CORE["βοΈ Core Framework\n(Constants, Themes, Notifications & Domain Utils)"]
DB["ποΈ Database & Storage Layer\n(Hive NoSQL Adapters & Functions)"]
CLOUD["βοΈ Cloud & Services\n(Firebase Options)"]
UI --> CORE
UI --> DB
CORE --> DB
UI --> CLOUD