Salesforce Fragment

When to Use This Skill

Use this skill when you need to:

• Create reusable UI fragments for Salesforce experiences
• Generate Fragment metadata following UEM structure
• Build fragments for Slack, Mobile, LEX, and other Salesforce experiences
• Troubleshoot deployment errors related to Fragments

Specification

Fragment Generation Guide

📋 Overview

Fragments are reusable pieces of UI similar to templates, with placeholders for actual data values. The purpose of this file is to assist developers in creating and editing fragments.

🎯 Purpose

Fragments render data in a structured and unified way across various Salesforce experiences like Slack, Mobile, LEX etc

⚙️ Composition

A fragment is a UEM (Unified Experience Model) tree of blocks and regions. The fragment you return must follow the Typescript interfaces below:

• Block definition: Follow {namespace}}/{{blockName} convention and use the same value as the block's definition when it appears in a fragment.

interface BlockType {
  type: 'block'
  definition: string  // {namespace}/{blockName}, e.g. "bcx/heading"
  attributes?: Record<string, any>
  children?: (BlockType | RegionType)[]
}

interface RegionType {
  type: 'region'
  name: string
  children: BlockType[]
}