b2c-scaffold_skill

Overview

This skill scaffolds Salesforce B2C Commerce components from templates to accelerate cartridge development. It generates cartridges, controllers, hooks, custom APIs, job steps, and Page Designer components with sensible defaults and interactive or scripted options. Use it to bootstrap new projects or add consistent, ready-to-edit artifacts to existing cartridges.

How this skill works

The scaffold command reads built-in or project-local templates and fills them with provided options (name, cartridge, routes, hook points, etc.). It supports interactive prompts, --option overrides for automation, dry-run previews, and --force to overwrite files. You can list, inspect, search, and validate scaffold templates before generating files.

When to use it

• Starting a new B2C cartridge with standard structure and files
• Adding a new SFRA controller with route and middleware boilerplate
• Creating hook implementations (system or OCAPI) and hooks.json registration
• Bootstrapping custom SCAPI endpoints (shopper/admin) with OAS skeletons
• Generating job steps (task or chunk) and registering in steptypes.json
• Creating Page Designer components with metadata and client assets

Best practices

• Prefer --dry-run to preview file changes before writing to disk
• Use --option flags in CI scripts to generate artifacts reproducibly
• Keep project-local scaffolds for company conventions and reuse
• Validate custom scaffolds with scaffold validate before sharing or committing
• Use descriptive cartridge and component names to avoid naming collisions

Example use cases

• Quickly create a new cartridge scaffolded to company standards and placed under src/cartridges
• Add an Account controller with Show and Submit routes using a single scaffold command
• Generate a system hook implementation wired into hooks.json for order calculations
• Bootstrap a shopper custom API with OpenAPI stub to implement loyalty endpoints
• Create a Page Designer component scaffold with group, id, and basic rendering assets