skills.rest
padjei
padjeiCOMMUNITY
Explore all skills by this author →
GitHub

experience-ui-bundle-custom-app-generate

Generates Salesforce CustomApplication metadata to host React UI bundles in Lightning Experience.

Updated Jul 2, 2026
Search Tags:#metadata generation#salesforce#sfdx#custom application#ui bundle#lightning experience#app launcher
One-click install
npx skills add https://github.com/padjei/SF_Build --skill experience-ui-bundle-custom-app-generate-padjei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: experience-ui-bundle-custom-app-generate
Source: https://github.com/padjei/SF_Build/tree/main/.claude/skills/experience-ui-bundle-custom-app-generate
Command: npx skills add https://github.com/padjei/SF_Build --skill experience-ui-bundle-custom-app-generate-padjei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating a Custom Application that correctly hosts a React UI bundle in the Lightning App Launcher requires version-aware metadata fields, and using the wrong field (uiBundle vs webApplication) produces a launcher entry that renders a blank page. ## Core Features & Use Cases - Version-Aware Field Discovery: Queries the salesforce-api-context MCP tools to detect whether the org's API version supports the uiBundle and target fields, then selects the correct XML elements. - Property Resolution with Fallback Chains: Resolves appName, appNamespace, and appLabel from sfdx-project.json, org queries, and naming conventions before generating any metadata. - Complete Metadata Generation: Produces the applications/*.app-meta.xml file and updates the .uibundle-meta.xml target element, with a deployment validation checklist. - Use Case: A developer has built a React UI bundle under uiBundles/myInternalApp/ and wants internal users to launch it from the Lightning App Launcher without setting up a Digital Experience Site. ## Quick Start Create a Custom Application for my UI bundle so it appears in the Lightning App Launcher.

Frequently Asked Questions about experience-ui-bundle-custom-app-generate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Salesforce Custom Application for a UI bundle?▼

Resolve the app name, namespace, and label, then generate an app-meta.xml file under applications/ referencing the UI bundle. The skill queries the org's API version to decide between the uiBundle and webApplication fields before writing the metadata.

What is the difference between uiBundle and webApplication fields in CustomApplication metadata?▼

The uiBundle field uses a namespace-qualified bundle name (namespace__appName) and exists in newer API versions, while webApplication uses the plain app name in older versions. Using the wrong one creates a launcher entry that shows a blank page.

Does a UI bundle app need a Digital Experience Site or CustomSite metadata?▼

No. Custom Applications for UI bundles act as thin launcher entries in Lightning Experience and do not require Networks, CustomSite, DigitalExperienceConfig, or DigitalExperienceBundle metadata.

Why does my Custom Application show a blank page in the App Launcher?▼

This usually means the bundle reference field does not match the org's API version, such as using uiBundle when only webApplication is supported, or an incorrect namespace prefix. Verify fields with get_metadata_type_fields before generating metadata.

How do I validate CustomApplication metadata before deploying?▼

Run sf project deploy validate --metadata CustomApplication UIBundle --target-org against your target org. The skill's checklist also confirms the app-meta.xml exists, the correct bundle field is used, and the UIBundle target element is set when supported.

Related Skills

Explore More Software Engineering Skills→
amanpraajamanpraaj
1

deploying-ui-bundle

Deploys Salesforce UI bundle apps through org authentication, metadata deployment, permission assignment, and GraphQL codegen.

Community
Intermediate
forcedotcomforcedotcom
803

generating-ui-bundle-site

Generate Salesforce Digital Experience metadata for hosting React UI bundles.

Official
Intermediate
dmckeeSFdmckeeSF

generating-ui-bundle-site

Generate Salesforce Digital Experience Site components for React UI bundles.

Community
Advanced
microsoftmicrosoft
2.9k

wiki-ado-convert

Convert VitePress/GFM markdown to Azure DevOps Wiki format via a Node.js build script.

Official
Advanced