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

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();

📚 API Reference #

FlexiCart Class #

CartInput Widget #

🙌 Contributions #

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