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 

🚀 Getting Started #

Basic Setup

• Create Cart Instance

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

/// Initialize the cart:
final cart = FlexiCart<ProductItem>();

• 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<ProductItem>>().add(product);

// Use in UI
CartInput<ProductItem>(
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 = Product(
   id: '123',
   name: 'Widget Pro',
   price: 29.99,
);
context.read<FlexiCart<Product>>().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 onCartChanged(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!