Cart

Headless cart management library

> ⚠️ Expect some breaking changes, Use at your own risk

🛒 Demo

• View React Demo
• Nextjs App Directory Demo

📦 Requirements

• React or Nextjs Project ⚛️

✨ Installation

• Install using the below command (with your package manager of choice)

# npm
npm install cart --save

# yarn
yarn add cart

#pnpm
pnpm add cart

# bun
bun install cart

💡 Usage Example

import React from "react";
import { useCart } from "cart";

const item = {
  productId: "123",
  name: "Product 1",
  quantity: 1,
  price: 10,
};

function Cart() {
  const {
    addToCart,
    cartItems,
    clearCart,
    decreaseItem,
    toggleCart,
    isCartOpen,
  } = useCart();

  return (
    <div>
      <p>{isCartOpen ? "Open" : "Closed"}</p>
      <button> toggleCart()}&gt;Toggle</button>
      <button> addToCart(item)}&gt;Add</button>

      <button> clearCart()}&gt;Clear</button>
      <button> decreaseItem("123", 1)}&gt;Decrease</button>

      <p>{JSON.stringify(cartItems)}</p>
    </div>
  );
}

export default Cart;

💡 SSR Example

import { useCart, withSSR } from "cart";
import React from "react";

const item = {
  productId: "123",
  name: "Product 1",
  quantity: 1,
  price: 10,
};

function MyCart() {
  const cart = withSSR(useCart, (state) => state);

  const handleToggle = () => {
    cart?.toggleCart();
  };

  const itemadd = () => {
    cart?.addToCart(item);
  };

  return (
    <div>
      <p>{cart?.isCartOpen ? "Open" : "Closed"}</p>
      <button> handleToggle()}&gt;Toggle</button>
      <button> itemadd()}&gt;Add</button>

      <button> cart?.clearCart()}&gt;Clear</button>
      <button> cart?.decreaseItem("123", 1)}&gt;Decrease</button>

      <p>{JSON.stringify(cart?.cartItems)}</p>
    </div>
  );
}

export default MyCart;

API Reference

🙏 Credits

Huge thanks to Peter Krumins for the package name cart. Please checkout Browserling - Online cross-browser testing platform.

(Btw, This is not a sponsored message, Just my way of saying thank you)

Contributors

Josh Goldberg ✨ 🔧

MC Naveen 💻 🖋 📖 🤔 🚇 🚧 📆 🔧

💚 Message

I hope you find this useful. If you have any questions, please create an issue.

> 💙 This package is based on @JoshuaKGoldberg's create-typescript-app.