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.jsonUsage
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>
);
}