Overview

Kitenzo Headless lets you take the bundles you’ve built in the Kitenzo admin and render them in any storefront — Shopify Hydrogen, Next.js, a TapCart mobile app, or a fully custom frontend — instead of (or alongside) a Liquid theme.

It exposes three things:

A REST API

Read your published bundles, their products and live pricing, validate a customer’s selection, and get back ready-to-use cart lines. Base URL https://live.bb.eight-cdn.com/api/headless/v1.

A typed SDK

@kitenzo/core (framework-agnostic) and @kitenzo/react (provider, hooks and the BundleEmbed component) wrap the API with full TypeScript types and a builder state machine.

A web component

<bundle-builder-bundle-v1> renders the exact admin-configured bundle UI — the same component used by Liquid themes — with no custom UI code.

Why it exists

Kitenzo’s full discount engine, conditions, limit rules and cart transform run on Shopify’s infrastructure. Headless storefronts can’t use the Liquid app embed, so they had no way to surface bundles. Headless closes that gap: the same backend engine that powers bundles in a theme is exposed over an authenticated API, so a bundle behaves identically whether it’s rendered in Liquid or in your own React app.

Same engine, same results

Pricing, validation and the Shopify cart transform that applies the discount at checkout are unchanged. Headless is a new way to read and configure bundles — not a different pricing system.

Who it’s for

• Hydrogen / Remix storefronts that want native bundles.
• Next.js and other custom React frontends.
• TapCart mobile apps — a custom block plus the /configure cart payload. See the TapCart guide.
• Any framework that can make an authenticated HTTP request and write to a Shopify cart.

What you’ll need

1. A Kitenzo installation with at least one published bundle.
2. The Headless feature enabled for your shop (currently invite-only — see Get access).
3. A headless API key (kit_live_… / kit_test_…), created in Settings → Headless.
4. A way to run Shopify cart mutations from your storefront (e.g. the Storefront API via @shopify/hydrogen-react).

Pick an integration mode Embed the full UI, or build your own with the SDK.

Jump to the quickstart From API key to first bundle in a few steps.