FlexiCart 🛒 #

A flexible, feature-rich cart management system for Flutter applications. FlexiCart provides reactive cart management with support for item grouping, quantity control, notes, delivery tracking, and custom business rules.

Features ✨ #

• Item Grouping - Organize items into logical groups (e.g., by category/vendor)
• Reactive Architecture - Built with ChangeNotifier for seamless state management
• Quantity Control - Precise quantity management with decimal support
• Custom Input Widget - Built-in CartInput widget with increment/decrement controls
• Delivery Tracking - Set and manage delivery dates/times
• Notes/Comments - Add cart-level notes
• Conditional Removal - Custom rules for item removal
• Type Safety - Generic implementation for any item type
• Deep Copying - Clone cart instances with complete state
• Mixins Support - Prevent disposed state notifications
• Lock/unlock cart for safe operations
• Cart expiration support set expired duration
• Stream-based state emission
• Plugin architecture for extending behavior
• Internal logging for debugging

Installation 📦 #

Add to your pubspec.yaml:

dependencies:
   flexi_cart: ^0.1.0
   provider: ^6.0.0 

Screenshots 📸 #

🚀 Getting Started #

Basic Setup

• Create Cart Instance

Provider(create: (_) => FlexiCart(...))

/// Initialize the cart:
final cart = FlexiCart();

• Define your item model Your model must implement the ICartItem interface.

class ProductItem extends ICartItem {
   // implement required properties like id, name, quantity, etc.
}

final product = ProductItem(...)

• Use CartInput Widget

final product = ProductItem(...);

// Add to cart
context.read<FlexiCart>().add(product);

// Use in UI
CartInput(
  item: product,
  decimalDigits: 2,
  maxQuantity: 100,
  onChanged: (updatedItem) {
  print("Quantity updated: ${updatedItem.quantity}");
  },
);

Basic Operations

• Initalize a cart item object and add it to cart

final product = ProductItem(
   id: '123',
   name: 'Widget Pro',
   price: 29.99,
);
context.read<FlexiCart>().add(product);

• Remove item from cart if existed

cart.delete(product);

• Get Total Calculation:

double total = cart.totalPrice();
int itemCount = cart.totalQuantity();

• Stream: Listen to cart changes reactively

cart.stream.listen((updatedCart) {
  print('Cart updated: ${updatedCart.items.length} items');
});

• Lock the cart to prevent changes

cart.lock();
try {
  cart.add(MockItem(id: '1', name: 'Apple', price: 2.0));
} catch (e) {
  print('Error: $e'); // Cart is locked.
}
cart.unlock(); // Now it's safe to mutate

• Set expiration

cart.setExpiration(Duration(minutes: 30));
print(cart.isExpired);

• Logs

print(cart.logs); // View history of cart changes

• Register plugin

cart.registerPlugin(PrintPlugin());

class PrintPlugin extends ICartPlugin<MockItem> {
  @override
  void onChange(FlexiCart<MockItem> cart) {
  print('Cart changed via plugin: ${cart.totalQuantity()} items');
  }
}

• CartDiff To track item changes between states:

final old = {...cart.items}; // snapshot
cart.add(newItem);
final diff = calculateCartDiff(old, cart.items);
print(diff.added); // List of added items

📚 API Reference #

FlexiCart Class #

CartInput Widget #

🙌 Contributions #

Feel free to fork, contribute, or suggest features. PRs are welcome!