Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 6 additions & 7 deletions docs/storefront/catalyst/development/b2b.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# B2B Edition

<Callout type="warning">
The information in this doc is **deprecated**.
Note that the Catalyst/B2B integration is **experimental**.

The current integration is experimental, and the code branch `integrations/b2b-buyer-portal` is deprecated. A more robust guide is in development and will be published soon.
A more robust setup/deployment guide is in development.
</Callout>

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. The steps below also document the process for running the B2B Buyer Portal React application locally, so that you can customize the experience inside of the Buyer Portal if required.
Expand All @@ -26,12 +26,11 @@ To create a B2B storefront on the Catalyst platform, you will need the following
- Git and a GitHub account.
- Node.js and PNPM.
- A Vercel account. Using your GitHub account to sign up is recommended for ease.
- A V3 BC API token.
- A V3 B2B API token. You can retrieve this from the B2B control panel under the "API Accounts" tab by clicking "Create API account." Ensure it is a V3 API token.
- A V3 BC API token. Note that this token must be granted the `modify` scope for B2B Edition.

### 1. Using Catalyst CLI

Carefully follow the process at [Manual Installation](/docs/storefront/catalyst/development/manual-installation). 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 integrations/b2b-buyer-portal`.
Carefully follow the process at [Manual Installation](/docs/storefront/catalyst/development/manual-installation). 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 integrations/b2b-makeswift`.

Supply a name for your project and answer all subsequent questions. Connect your BigCommerce account and select the target store. Installing sample data is optional.

Expand All @@ -57,14 +56,14 @@ Also add the B2B related environment variables:

- B2B_API_HOST: https://api-b2b.bigcommerce.com.
- This is the domain of the B2B API. NOTE: Make sure this value does not have a trailing slash.
- B2B_API_TOKEN: The V3 B2B API token obtained during the preparation step.
- BIGCOMMERCE_ACCESS_TOKEN: The V3 API token obtained during the preparation step.

Once all environment variables are set, we can proceed with deployment.

1. Sign in to your Vercel account. You should be redirected to your projects dashboard.
2. Click on `Add new > Project`.
3. Select the repository you created a fork for. If this is your first time deploying with Vercel, you will need to grant access to one or more repositories. It is recommended to give Vercel access only to specific repositories.
4. In the "New Project" form, ensure the framework preset is set to Next.js and the root directory is core. Make sure the project points to the `integrations/b2b-buyer-portal` branch.
4. In the "New Project" form, ensure the framework preset is set to Next.js and the root directory is core. Make sure the project points to the `integrations/b2b-makeswift` branch.
5. Click `Deploy`.

If you need to redeploy your project, go to `Deployments > Create` deployment and specify the desired branch. You can also configure Vercel to automatically monitor for changes and deploy them by going to `Project -> Settings -> Environments` and selecting the desired branch for tracking.
Expand Down