initial commit

Author: DeanLJY

.gitignore

@@ -0,0 +1,29 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+build/

LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.

README.md

@@ -0,0 +1,108 @@
+# FlutterCart: Your Mobile Shopping Companion
+
+FlutterCart is a versatile Flutter package that brings robust shopping cart capabilities to your mobile application. It leverages Hive for local storage, ensuring your shopping cart data is retained across different app sessions.
+
+## Key Features
+
+- **Initialization**: Kickstart the shopping cart with the `init()` method.
+- **Cart Operations**: Include items to the cart with `addToCart`, and remove them using `removeFromCart`.
+- **Quantity Control**: Fine-tune the item quantity with `incrementCartItemQuantity` and `decrementCartItemQuantity`.
+- **Total Price Calculation**: Fetch the total price of cart items using `calculateTotalPrice`.
+- **Item Count**: Retrieve the total number of items with `getCartItemCount`.
+- **Cart Clearance**: Wipe out all items from the cart with `clearCart`.
+- **Cart Item Display**: Visualize the cart items with `showCartItems`, offering customizable widgets for individual cart items and an empty cart message.
+- **Item Count Widget**: Display a widget featuring the current cart item count using `showCartItemCountWidget`.
+- **Total Amount Widget**: Showcase a widget revealing the total amount of items in the cart with `showTotalAmountWidget`.
+- **Dynamic Cart Item Widget**: Illustrate a widget that updates based on whether a product is in the cart or not, using `showAndUpdateCartItemWidget`.
+- **Cart Data Retrieval**: Use `getCartData` in the `FlutterCart` class to fetch a list of cart items and the total price.
+
+## How to Get Started
+
+1. Incorporate the package in your Dart file:
+
+```dart
+import 'package:flutter_cart/flutter_cart.dart';
+```
+
+2. Set the ball rolling by initializing the cart:
+
+```dart
+await FlutterCart().init();
+```
+
+3. You're all set to harness the shopping cart features in your application!
+
+## Usage Examples
+
+```dart
+// Add products to the cart
+await FlutterCart().addToCart(FlutterCartItem());
+
+// Eliminate a product from the cart
+await FlutterCart().removeFromCart(productId);
+
+// Increase the product quantity in the cart
+await FlutterCart().incrementCartItemQuantity(productId);
+
+// Reduce the product quantity in the cart
+await FlutterCart().decrementCartItemQuantity(productId);
+
+// Fetch the total price of cart items
+double totalPrice = FlutterCart().calculateTotalPrice();
+
+// Get the total quantity of cart items
+int itemCount = FlutterCart().getCartItemCount();
+
+// Empty the cart
+FlutterCart().clearCart();
+
+// Fetch cart data and total price
+Map<String, dynamic> cartData = FlutterCart().getCartData();
+List<FlutterCartItem> cartItems = cartData['cartItems'];
+double totalPriceFromData = cartData['totalPrice'];
+```
+
+## Widgets
+
+### Cart Item Display
+
+```dart
+FlutterCart().showCartItems(
+  cartTileWidget: ({required FlutterCartItem data}) {
+    // Your personalized cart item widget
+  },
+  showEmptyCartMsgWidget: YourEmptyCartMessageWidget(),
+);
+```
+
+### Cart Item Count Widget
+
+```dart
+FlutterCart().showCartItemCountWidget(
+  cartItemCountWidgetBuilder: (int itemCount) {
+    // Your personalized widget displaying the cart item count
+  },
+);
+```
+
+### Total Amount Widget
+
+```dart
+FlutterCart().showTotalAmountWidget(
+  cartTotalAmountWidgetBuilder: (double totalAmount) {
+    // Your personalized widget displaying the total amount
+  },
+);
+```
+
+### Dynamic Cart Item Widget
+
+```dart
+FlutterCart().showAndUpdateCartItemWidget(
+  inCartWidget: YourInCartWidget(),
+  notInCartWidget: YourNotInCartWidget(),
+  product: yourProduct,
+);
+```
+
+"Simplify your mobile shopping experience with FlutterCart!"

analysis_options.yaml

@@ -0,0 +1,4 @@
+include: package:flutter_lints/flutter.yaml
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options

lib/flutter_cart.dart

@@ -0,0 +1,7 @@
+library flutter_cart;
+
+/// A Calculator.
+class Calculator {
+  /// Returns [value] plus 1.
+  int addOne(int value) => value + 1;
+}

pubspec.yaml

@@ -0,0 +1,54 @@
+name: flutter_cart
+description: "A new Flutter package project."
+version: 0.0.1
+homepage:
+
+environment:
+  sdk: '>=3.2.3 <4.0.0'
+  flutter: ">=1.17.0"
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^2.0.0
+
+# For information on the generic Dart part of this file, see the
+# following page: https://dart.dev/tools/pub/pubspec
+
+# The following section is specific to Flutter packages.
+flutter:
+
+  # To add assets to your package, add an assets section, like this:
+  # assets:
+  #   - images/a_dot_burr.jpeg
+  #   - images/a_dot_ham.jpeg
+  #
+  # For details regarding assets in packages, see
+  # https://flutter.dev/assets-and-images/#from-packages
+  #
+  # An image asset can refer to one or more resolution-specific "variants", see
+  # https://flutter.dev/assets-and-images/#resolution-aware
+
+  # To add custom fonts to your package, add a fonts section here,
+  # in this "flutter" section. Each entry in this list should have a
+  # "family" key with the font family name, and a "fonts" key with a
+  # list giving the asset and other descriptors for the font. For
+  # example:
+  # fonts:
+  #   - family: Schyler
+  #     fonts:
+  #       - asset: fonts/Schyler-Regular.ttf
+  #       - asset: fonts/Schyler-Italic.ttf
+  #         style: italic
+  #   - family: Trajan Pro
+  #     fonts:
+  #       - asset: fonts/TrajanPro.ttf
+  #       - asset: fonts/TrajanPro_Bold.ttf
+  #         weight: 700
+  #
+  # For details regarding fonts in packages, see
+  # https://flutter.dev/custom-fonts/#from-packages

test/flutter_cart_test.dart

@@ -0,0 +1,12 @@
+import 'package:flutter_test/flutter_test.dart';
+
+import 'package:flutter_cart/flutter_cart.dart';
+
+void main() {
+  test('adds one to input values', () {
+    final calculator = Calculator();
+    expect(calculator.addOne(2), 3);
+    expect(calculator.addOne(-7), -6);
+    expect(calculator.addOne(0), 1);
+  });
+}