Bolt.new AI and Salesforce Commerce Cloud integration: Step-by-Step Guide 2025

 

Configuring Project Dependencies

 

• Create a new file named package.json in the root of your Bolt.new AI project. This file will list your project dependencies. Since Bolt.new AI doesn’t have a terminal, add the following JSON content directly to this file to include the necessary dependencies:

{
  "name": "bolt-sfcc-integration",
  "version": "1.0.0",
  "dependencies": {
    "node-fetch": "^3.0.0"
  },
  "type": "module"
}
  

• When your project is saved, Bolt.new AI will automatically recognize these settings.

 

Creating the Salesforce Commerce Cloud Integration File

 

• Create a new file in your project and name it salesforceIntegration.ts. This file contains the functions to connect with Salesforce Commerce Cloud using its API.
• Add the following code to salesforceIntegration.ts. This code defines a class that handles authentication and product retrieval:

import fetch from 'node-fetch';

export interface SFCCCredentials {
  clientId: string;
  clientSecret: string;
  baseUrl: string;
}
export class SalesforceCommerceCloud {
  private credentials: SFCCCredentials;
  constructor(credentials: SFCCCredentials) {
    this.credentials = credentials;
  }
  // Method to retrieve an access token using client credentials
  async authenticate(): Promise {
    const authEndpoint = ${this.credentials.baseUrl}/dw/oauth2/access_token;
    const params = new URLSearchParams();
    params.append('client_id', this.credentials.clientId);
    params.append('client_secret', this.credentials.clientSecret);
    params.append('granttype', 'clientcredentials');
const response = await fetch(authEndpoint, {
  method: 'POST',
  body: params
});
const data = await response.json();
// Returns the access token provided by Salesforce Commerce Cloud
return data.access_token;

  }
  // Example method to fetch product data using a product ID
  async getProduct(productId: string): Promise {
    const token = await this.authenticate();
    const productEndpoint = ${this.credentials.baseUrl}/s/-/dw/data/v21_3/products/${productId};
    const response = await fetch(productEndpoint, {
      method: 'GET',
      headers: {
        'Authorization': Bearer ${token},
        'Content-Type': 'application/json'
      }
    });
    return response.json();
  }
}
  

 

Setting Up the Configuration File for Credentials

 

• Create another new file named config.ts in your project root. This file holds your Salesforce Commerce Cloud credentials and base URL configuration.
• Insert the following code into config.ts, replacing the placeholder values with your actual credentials:

export const SFCCConfig = {
  clientId: 'YOURCLIENTID',
  clientSecret: 'YOURCLIENTSECRET',
  baseUrl: 'https://your-instance.demandware.net'
};
  

 

Integrating Salesforce Commerce Cloud into Your Main Application

 

• Open your main Typescript file (commonly index.ts or similar) within your Bolt.new AI project.
• Add the following code snippet to import and utilize the Salesforce Commerce Cloud integration. This example shows how to fetch product data and log it to the console:

import { SalesforceCommerceCloud } from './salesforceIntegration';
import { SFCCConfig } from './config';

const sfcc = new SalesforceCommerceCloud(SFCCConfig);
async function testProduct() {
  try {
    const productData = await sfcc.getProduct('sample-product-id');
    console.log('Product Data:', productData);
  } catch (error) {
    console.error('Error fetching product:', error);
  }
}
testProduct();
  

 

Final Steps and Testing

 

• Ensure all files (package.json, salesforceIntegration.ts, config.ts, and your main Typescript file) are saved.
• Your project is now set up to integrate with Salesforce Commerce Cloud via API calls. When the application runs, it will use the salesforceIntegration.ts module to authenticate and fetch data from Salesforce Commerce Cloud.