Velocity X Components by Aidxn Design

E-Commerce

Bundle Upsell Block

Frequently-bought-together block: a main product plus checkbox add-ons, a live combined total and one Add-bundle button.

Lifetime access Included with the VX Components lifetime licence.
bash
$ velocityx add bundle-upsell-block

Built for react. Needs react already installed as a peer dependency. An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.

Full docs for Bundle Upsell Block →

Needs a licence key — buy lifetime access here, then velocityx login once.

react v1.0.0
Bundle Upsell Block

Frequently bought together

  • $0.00

Total for 1 item

$0.00
Framework
react
Source
157 lines
BundleUpsellBlock.jsx
Runtime
Interactive
runs in the browser
Theme
2 tokens
re-themes from your scale
Dark mode
Built in
dark: variants
Accessibility
1 ARIA
attributes and roles

Props

NameTypeRequiredDefaultDescription
mainItem{ id, name, price, image? }Yes
addOns{ id, name, price, image? }[]No[]
selectedAddOnIdsstring[]No[]
onToggleAddOn(id) => voidYes
onAddBundle() => Promise<void>Yes| void
currencystringNo'AUD'
localestringNo'en-AU'

Using it

The smallest call that compiles — required props only. The import is written for your own file at src/components/Example.jsx; adjust the relative import if yours sits elsewhere. Everything optional is in the table above, with its default.

tsx
import BundleUpsellBlock from './velocity/bundle-upsell-block/BundleUpsellBlock';

export default function Example() {
  return (
    <BundleUpsellBlock
      mainItem={{}}
      onToggleAddOn={() => {}}
      onAddBundle={() => {}}
    />
  );
}

Built from Bundle Upsell Block's own prop signature and the path the CLI installs it to, so it can't drift from either.

Accessibility

ARIA attributes
aria-hidden
Keyboard
Built on native controls — Enter/Space work as standard

Read from the source, not asserted — anything not listed simply isn't in this component's markup.

Behaviour

Ships client JS
Yes — this one needs to hydrate
React hooks
useState
Dark mode
Carries its own dark: variants

Theming

This component paints from 2 steps of your theme scale — no hardcoded colours, and no font-family of its own, so your type cascade wins. Override the variables and it follows.

primary-600primary-700

Get the Velocity preset and CSS theme from the public source guide. The CLI theme command is not available on npm yet.

File this creates

The CLI writes this path into your project — nothing else moves. Paths are under your source root, which defaults to src/; pass --dest if yours is elsewhere.

  • src/components/velocity/bundle-upsell-block/BundleUpsellBlock.jsx 157 lines
Copy the paths
text
src/components/velocity/bundle-upsell-block/BundleUpsellBlock.jsx

Bundle Upsell Block — questions

How do I install Bundle Upsell Block?

Run velocityx add bundle-upsell-block . The CLI writes the source straight into your project — it is not a runtime package dependency.

Do I need a licence for Bundle Upsell Block?

Yes. It is part of the lifetime library — buy access at https://aidxn.com/shop/velocity-x-component-library/, authenticate once, and install it. Your lifetime licence includes future component updates.

Can I edit Bundle Upsell Block after installing it?

Yes — the files are yours once written. The CLI compares its lockfile hash before upgrades and refuses to overwrite code you changed.

Does Bundle Upsell Block ship JavaScript to my users?

Yes. It runs in the browser (useState), so it needs to hydrate — in Astro, give it a client:* directive.

Will Bundle Upsell Block match my brand colours?

Yes. It paints entirely from your theme scale — 2 steps of primary-* / accent-* — with no hardcoded hex values and no font-family of its own. Override the theme CSS variables and it follows your design system instead of ours.

Does Bundle Upsell Block pull in any dependencies?

No external ones. Every component in the library is built with react/react-dom or plain Astro only — no GSAP, Radix, Swiper or Headless UI — which is what makes dropping it into an existing project safe.

Set up & reference

All docs →

Install this component:

bash
$ velocityx add bundle-upsell-block

More from E-Commerce.