B2B Edition

Following these steps will help you integrate Catalyst with B2B Edition's Open Source Buyer Portal, which is a traditional client-side rendered React application.

This implementation primarily handles authentication with the B2B Storefront API and triggering the render of the Buyer Portal on top of Catalyst. It is similar to the experience currently available for BigCommerce's Stencil storefront framework.

If you are looking to integrate directly into Catalyst's routes and components, this can be done by integrating B2B Edition's APIs (opens in a new tab). We've seen this happen organically and are working on streamlining this path as well.

Prerequisites

• You should have B2B Edition activated on your BigCommerce Store, with at least one B2B Edition Company and Customer added to that Company.
• Reach out to the B2B Edition team at b2b@bigcommerce.com to enable GraphQL Proxy CAT support if your store was created before January 1st, 2025.

Getting Started

1. Carefully follow https://www.catalyst.dev/docs/installation (opens in a new tab). Ensure you have met the prerequisites linked at the top of that page. Replace the Catalyst CLI command with: pnpm create @bigcommerce/catalyst@latest --gh-ref wip/b2b
2. Open the B2B Edition dashboard in your store’s Control Panel (opens in a new tab), then navigate to Settings > API Accounts > Create API Account. Copy the value and add it in your .env.local as B2B_API_TOKEN
3. While still in the B2B Edition dashboard, navigate to Storefronts and click the ellipsis (...) next to your Catalyst Headless Storefront Channel. Click “Enable B2B” and ensure the channel updates to “B2B Enabled”
4. Run pnpm dev from your local Catalyst repository
5. Attempt to login and see you are redirected to the Buyer Portal