@kitenzo/react

v0.2.6 · published

React bindings. Re-exports everything in @kitenzo/core and adds a provider, hooks and the BundleEmbed component.

npm install @kitenzo/react

• Depends on: @kitenzo/core.
• Peer deps: react >= 18, react-dom >= 18. Optional @shopify/hydrogen-react >= 2024.0.0.

Public exports

Provider

Export	Kind	Doc
KitenzoProvider	component	Provider & client
useKitenzo	hook	Returns the KitenzoClient.
useSettings	hook	Returns ShopSettings | null.

Hooks

Export	Returns	Doc
useBundles	{ bundles, isLoading, error, refetch }	Hooks
useBundle	{ bundle, isLoading, error, refetch }	Hooks
useBundleBuilder	builder state + methods	Hooks
useBundlePrice	price fields (raw + formatted)	Hooks
useBundleCart	{ addBundleToCart, isLoading, error, lastResult }	Hooks

Components

Export	Kind	Doc
BundleEmbed	component	React — BundleEmbed

BundleEmbed is the only component

@kitenzo/react exports exactly one component — BundleEmbed (for Mode 1). There is no <BundleBuilder>, <BundleCard>, <BundlePrice> or similar — UI for custom builds (Mode 2) is intentionally left to you. Compose it from the hooks above.

Re-exports from core

All of @kitenzo/core is available from @kitenzo/react, so a React app installs one package:

import {
  KitenzoProvider, useBundle, useBundleBuilder, useBundlePrice, useBundleCart, BundleEmbed,
  KitenzoClient, createBundleBuilder, addBundleToCart, buildCartPayload, calculatePrice, formatMoney,
} from '@kitenzo/react';

Plus every TypeScript type.