Commerce Promo Builder
Online store admin panel to define coupons and promotions with a cart preview.
Choose the primitives library your project already uses. Both look the same: your theme, not the variant, controls colors, shape, type and motion.
About this feature
What it's for
- Online store admin panel to define coupons and promotions with a cart preview.
- Discount configurator by category or whole cart with a maximum cap and minimum subtotal.
- Editor for buy-x-get-y and free shipping campaigns with a simulated sample order.
For applying a coupon from the customer checkout, use Billing Checkout Flow. For managing base catalog prices, use Ecommerce Product Editor.
Includes
- Discount rule editor
- Percentage fixed bxgy free shipping rules
- Rule scope cart or category
- Minimum subtotal conditions
- Percentage cap
- Stackable or best rule resolution
- Live cart preview
- Per line discount breakdown
Works with
- Radix UI and Base UI primitives (pick the one your project uses)
- React 19, Next.js App Router and Tailwind CSS 4, installed with the shadcn CLI
- Your theme tokens, in light and dark mode
Install
Included with Agentic UI Kit (one-time license). Install needs your license key: see pricing · connect your project.
agentic-ui add commerce-promo-buildernpx shadcn@4.17.0 add @agentic-ui/commerce-promo-builderUsed in
A standalone component: drop it into any screen.
- Type
- Feature
- Variants
- Radix UI and Base UI
- Themes
- Light and dark
- Widths
- Preview it at desktop, tablet and mobile widths above.
- Motion
- Animated, with a reduced-motion fallback
- Sample data
- Ships with sample data in its own files; replace it with your own.
- npm packages
lucide-react- Registry dependencies
lib-primitives- Files
4 files
- components/agentic-ui/commerce-promo-builder/index.tsx
- components/agentic-ui/commerce-promo-builder/fixtures.ts
- components/agentic-ui/commerce-promo-builder/types.ts
- components/agentic-ui/commerce-promo-builder/engine.ts
Related components
Commerce Cart Drawer
Storefront side cart opened from the header bag icon after add-to-cart.
Details and live previewCommerce Order Tracking
Order tracking page in an online store with statuses, ETA and the carrier's route map.
Details and live previewCommerce Returns Flow
Self-service return flow for a fashion or electronics ecommerce shopper.
Details and live previewCommerce Reviews Block
Customer ratings and reviews section on e-commerce product pages.
Details and live preview