From salesforce-commerce
Sets up Salesforce Commerce dev environment with sfcc-ci CLI for B2C, sf CLI for B2B, Business Manager access, sandbox management, dw.json/.sfdx config, and SFRA/PWA Kit/Lightning project structures. Use for new projects.
npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin salesforce-commerceThis skill is limited to using the following tools:
**Fetch live docs before setting up a project.**
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides MCP server integration in Claude Code plugins via .mcp.json or plugin.json configs for stdio, SSE, HTTP types, enabling external services as tools.
Fetch live docs before setting up a project.
https://github.com/SalesforceCommerceCloud/sfcc-ci for sfcc-ci CLI commandshttps://github.com/SalesforceCommerceCloud/storefront-reference-architecture for SFRA referenceB2C Commerce (SFCC) requires:
dev01-realm-customer.demandware.net)B2B Commerce (Lightning) requires:
npm install -g @salesforce/cli)| Tool | Platform | Install | Auth |
|---|---|---|---|
| sfcc-ci | B2C | npm install -g sfcc-ci | sfcc-ci client:auth (client ID + secret) |
| sf CLI | B2B | npm install -g @salesforce/cli | sf org login web or sf org login jwt |
Key sfcc-ci Commands:
sfcc-ci code:deploy -- upload code to sandboxsfcc-ci code:activate -- activate a code versionsfcc-ci sandbox:create / sandbox:list -- manage on-demand sandboxessfcc-ci job:run -- execute Business Manager jobsKey sf CLI Commands:
sf project deploy start -- deploy metadata to orgsf org create scratch -- create scratch orgsf apex run test -- run Apex testssf data import tree -- import sample dataB2C SFRA Cartridge Project:
sfra-project/
cartridges/
app_storefront_base/ # Base (never modify)
app_custom_storefront/ # Custom overlay
cartridge/
controllers/, models/, scripts/
templates/, client/ (js, scss)
dw.json, package.json, webpack.config.js
B2C PWA Kit Project:
pwa-kit-project/
app/
components/, pages/, hooks/, utils/
commerce-api/ # Commerce Cloud API client
config/
default.js, production.js
package.json, .env
B2B Lightning Project:
b2b-lightning-project/
force-app/main/default/
lwc/, classes/, triggers/
objects/, flexipages/
experiences/, permissionsets/
config/project-scratch-def.json
sfdx-project.json, .forceignore
dw.json (B2C):
.env excluded from VCSsfdx-project.json (B2B):
.forceignore (B2B):
B2C dw.json fields:
hostname -- sandbox domainusername / password -- credentials (prefer env vars)code-version -- target code versioncartridges -- array of cartridge names to uploadexclude -- files/directories to skipB2B sfdx-project.json fields:
packageDirectories -- array of source paths (typically force-app)sourceApiVersion -- Salesforce API version (e.g., "61.0")namespace -- package namespace (empty for unmanaged)sfdcLoginUrl -- org login URL| Type | Platform | Purpose |
|---|---|---|
| Development sandbox | B2C | Developer-specific feature work |
| Staging sandbox | B2C | Pre-production validation |
| On-demand sandbox | B2C | Temporary, via sfcc-ci sandbox:create |
| Scratch org | B2B | Short-lived, disposable dev org |
| Developer sandbox | B2B | Partial copy of production |
| Full sandbox | B2B | Full copy of production for UAT |
Store credentials as environment variables, never in committed files.
B2C: SFCC_CLIENT_ID, SFCC_CLIENT_SECRET, SFCC_HOSTNAME, SFCC_USERNAME, SFCC_PASSWORD, SFCC_CODE_VERSION
B2B: SF_USERNAME, SF_ORG_ALIAS, SF_CLIENT_ID, SF_JWT_KEY_FILE (for CI/CD connected app auth)
| Deprecated | Replacement |
|---|---|
| dwupload | sfcc-ci |
| sfdx CLI (old) | sf CLI (unified) |
| Prophet Debugger | Official Salesforce VS Code extensions |
sfcc-ci for all deployments; never use manual WebDAV uploadapp_storefront_base directly; always overlay in custom cartridgenpm run compile:js, npm run compile:scss) before deploymentdw.json out of version control (add to .gitignore)sf project deploy start for metadata deployment; avoid Change Setssf project deploy preview) to review changes before deployFetch the sfcc-ci documentation, SFRA getting-started guide, and sf CLI reference for exact commands and latest project structures before setting up.