DDBS UI
commerce

Store UI Provider

createStoreUi builds a store's UI state provider: drawer, quick view, search, map, sign-in, size guide and toasts, plus the add-to-bag handler.

npx shadcn@latest add https://ui.develop-better-solutions.com/r/store-ui-provider.json
Fullscreen

Usage

store-ui-provider-example.tsx
"use client";

import { useState } from "react";
import { AuthModal, CloseButton, ModalShell, StoreMapModal, Toasts, createStoreUi } from "@dbs/ui";
import { PRODUCTS, StoreScope, triggerClass, type DemoProduct } from "./_store";

// A tiny cart hook: createStoreUi only needs add, toggleFavorite and favorites.
function useDemoCart() {
  const [favorites, setFavorites] = useState<ReadonlySet<string>>(new Set());
  return {
    add: () => undefined,
    favorites,
    toggleFavorite: (id: string) => {
      const next = new Set(favorites);
      const on = !next.has(id);
      if (on) next.add(id);
      else next.delete(id);
      setFavorites(next);
      return on;
    },
  };
}

const Drawer = ({ open, onClose }: { open: boolean; onClose: () => void }) => (
  <ModalShell open={open} onClose={onClose} labelId="ui-cart" variant="drawer">
    <div className="flex items-center justify-between p-5">
      <h2 id="ui-cart" className="text-lg font-bold">Your bag</h2>
      <CloseButton onClick={onClose} label="Close cart" />
    </div>
  </ModalShell>
);
const None = () => null;

// One call builds the store's UiProvider and useUi hook. The dialogs are yours
// (or the shared ones); the provider owns their open state, toasts and handlers.
const { UiProvider, useUi } = createStoreUi<DemoProduct, string>({
  theme: { prefix: "store", Link: "a" },
  useCart: useDemoCart,
  addedTitle: "Added to cart",
  describeAdded: (p) => p.name,
  resolveColorId: (_p, id) => id,
  directionsMessage: "Opening directions to Atlas Casablanca.",
  components: () => ({
    CartDrawer: Drawer,
    QuickViewModal: None,
    SearchModal: None,
    StoreMapModal: (p) => (
      <StoreMapModal
        {...p}
        name="Atlas Casablanca"
        blurb="Our flagship store."
        address="14 Rue Moulay Youssef, Casablanca"
        phone="+212 522 00 00 00"
        hours={[["Mon to Sat", "10:00 to 20:00"]]}
        map={{ surface: "var(--color-surface)", road: "var(--color-canvas)", minorRoad: "var(--color-line)", block: "var(--color-surface-raised)" }}
      />
    ),
    AuthModal: (p) => <AuthModal {...p} signUpBlurb="Join Atlas." signInBlurb="Welcome back." />,
    Toasts,
  }),
});

function Buttons() {
  const ui = useUi();
  return (
    <div className="flex flex-wrap gap-3">
      <button type="button" className={triggerClass} onClick={() => ui.addToBag(PRODUCTS[0]!, "sand", "one")}>
        Add to bag
      </button>
      <button type="button" className={triggerClass} onClick={ui.openCart}>Open cart</button>
      <button type="button" className={triggerClass} onClick={ui.openMap}>Find a store</button>
      <button type="button" className={triggerClass} onClick={ui.toggleLogin}>
        {ui.userName ? "Sign out" : "Sign in"}
      </button>
    </div>
  );
}

export default function StoreUiProviderExample() {
  return (
    <StoreScope minHeight={520}>
      <UiProvider>
        <Buttons />
      </UiProvider>
    </StoreScope>
  );
}