mcpField
G
generating-ui-bundle-features

generating-ui-bundle-features

github.com/forcedotcomDevelopment1.1k3.7k installsUpdated 1d ago
Repository

About generating-ui-bundle-features

A workflow skill for finding and installing pre-built features in Salesforce UI bundles. It guides developers through search, inspection, installation, conflict handling, and example integration.

Key features

  1. 01Search existing project code
  2. 02Find and inspect available features
  3. 03Install features with conflict handling
  4. 04Integrate example files

Use cases

  1. 01Check for an existing feature before custom development
  2. 02Preview and install a feature into a UI bundle
  3. 03Resolve installation conflicts in non-interactive runs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/forcedotcom/sf-skills --skill generating-ui-bundle-features

After installing, type/generating-ui-bundle-featuresin Claude Code to confirm it loaded.

Details

From the project README

UI Bundle Features

Installing Pre-built Features

Always check for an existing feature before building something from scratch. The features CLI installs pre-built, tested packages into Salesforce UI bundles — from foundational UI libraries (shadcn/ui) to full-stack capabilities (authentication, search, navigation, GraphQL, Agentforce AI).

Workflow

  1. Search project code first — check src/ for existing implementations before installing anything. Scope searches to src/ to avoid matching node_modules/ or dist/.

  2. Search available features — use npx @salesforce/ui-bundle-features list with --search <query> to filter by keyword. Use --verbose for full descriptions.

  3. Describe a feature — use npx @salesforce/ui-bundle-features describe <feature> to see components, dependencies, copy operations, and example files.

  4. Install — use npx @salesforce/ui-bundle-features install <feature> --ui-bundle-dir <name>. Key options:

    • --dry-run to preview changes
    • --yes for non-interactive mode (skips conflicts)
    • --on-conflict error to detect conflicts, then --conflict-resolution <file> to resolve them

If no matching feature is found, ask the user before building a custom implementation — a relevant feature may exist under a different name.

Conflict Handling

In non-interactive environments, use the two-pass approach: first run with --on-conflict error to detect conflicts, then create a resolution JSON file ({ "path": "skip" | "overwrite" }) and re-run with --conflict-resolution.

Post-install: Integrating Example Files

Features may include __example__ files showing integration patterns. For each:

  1. Read the example file to understand the pattern
  2. Read the target file (shown in describe output)
  3. Apply the pattern from the example into the target
  4. Delete the example file after successful integration
Hint Placeholders

Some copy paths use <descriptive-name> placeholders (e.g., <desired-page-with-search-input>) that the CLI does not resolve. After installation, rename or relocate these files to the intended target, or integrate their patterns into an existing file.

Comments

Markdown supported