Skip to content

refactor: rename webapp template generate command to ui-bundle @W-21575871@#889

Merged
iowillhoit merged 16 commits intosalesforcecli:mainfrom
deepu-mungamuri94:rename-webapp-to-ui-bundle
Mar 30, 2026
Merged

refactor: rename webapp template generate command to ui-bundle @W-21575871@#889
iowillhoit merged 16 commits intosalesforcecli:mainfrom
deepu-mungamuri94:rename-webapp-to-ui-bundle

Conversation

@deepu-mungamuri94
Copy link
Copy Markdown
Collaborator

What does this PR do?

Renames the sf template generate webapp command to sf template generate ui-bundle to align with the updated metadata type naming convention.

Changes:

  • src/commands/template/generate/webapp/ → renamed to ui-bundle/
  • messages/webApplication.md → renamed to messages/ui-bundle.generate.md
  • export const UI_BUNDLES_DIR = 'uiBundles' added to index.ts as single source of truth
  • NUT updated to use a local const UI_BUNDLES_DIR = 'uiBundles' (kept separate from source import to avoid TypeScript any resolution issues at lint time) and projectDir to avoid unsafe any path joins
  • command-snapshot.json, package.json, CLAUDE.md, skill file updated

What issues does this PR fix or reference?

@W-21575871@

@deepu-mungamuri94 deepu-mungamuri94 requested a review from a team as a code owner March 27, 2026 08:04
@deepu-mungamuri94 deepu-mungamuri94 force-pushed the rename-webapp-to-ui-bundle branch from 8b6e192 to 45e5a6f Compare March 27, 2026 08:10
Rename `sf template generate webapp` to `sf template generate ui-bundle`:

- Rename src/commands/template/generate/webapp/ to ui-bundle/
- Rename messages/webApplication.md to messages/ui-bundle.generate.md
- Extract UI_BUNDLES_DIR constant for the uiBundles folder name
- Update command-snapshot.json with new ui-bundle command entry
- Update package.json oclif topics to reflect ui-bundle namespace
- Update CLAUDE.md and add-template-generator skill with ui-bundle examples

W-21575871

Made-with: Cursor
@deepu-mungamuri94 deepu-mungamuri94 force-pushed the rename-webapp-to-ui-bundle branch from 45e5a6f to f86dc7e Compare March 27, 2026 08:12
deepu-mungamuri94 and others added 2 commits March 27, 2026 13:44
…nternalapp/reactexternalapp

- Replace deprecated reactb2e and reactb2x template names with
  reactinternalapp and reactexternalapp in the project generate command
  options, improving clarity by reflecting the internal vs external
  audience distinction instead of opaque B2E/B2X codes
- Add nativemobile as a new supported template option
- Bump @salesforce/templates to 66.6.2 to pick up the uiBundles
  output directory rename (previously webapplications) and aligned
  internal template identifiers
- Update NUT tests to use the new template names and uiBundles path
- Update messages to document the renamed templates correctly

Made-with: Cursor
The analytics template provides similar files and the force-app/main/default/waveTemplates directory.

The reactb2e and reactb2x templates provide React-based project scaffolding for B2E and B2X web application use cases.
The reactinternalapp and reactexternalapp templates provide React-based project scaffolding for internal and external web application use cases.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this change is correct. The previous names are the expected template names.

@jshackell-sfdc correct me if I'm wrong.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this is valid change when I've cross checked with webapps(ui-bundle).

1. webapps (template implementations)
      ↓
2. salesforcedx-templates (template generator library)
      ↓
3. plugin-templates (SF CLI plugin)
Detailed Flow:
webapps - Creates actual React template apps (reactinternalapp, reactexternalapp)

Published as NPM packages: @salesforce/ui-bundle-template-app-react-template-b2e and @salesforce/ui-bundle-template-app-react-template-b2x
salesforcedx-templates - Consumes webapps templates as devDependencies and includes them in the project generator

Published as: @salesforce/templates (version 66.6.2)
Defines valid template names in [projectGenerator.ts](vscode-webview://19bsi4cc8l4eosqhhi7cgsjkq4l73le1gkl6e1o010h8218uon0f/salesforcedx-templates/src/generators/projectGenerator.ts#L21-L22)
plugin-templates - SF CLI plugin that depends on @salesforce/templates

Exposes templates via CLI commands like sf template generate project

Links :

Correct me if I'm wrong.

'reactexternalapp',
'agent',
'nativemobile',
] as const,
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above. I don't think these need to be changed.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

garychangsf and others added 12 commits March 29, 2026 14:05
Co-authored-by: Brian Buchanan <5377888+bpbuch@users.noreply.github.com>
Co-authored-by: Brian Buchanan <5377888+bpbuch@users.noreply.github.com>
Co-authored-by: Brian Buchanan <5377888+bpbuch@users.noreply.github.com>
Removes volta configuration from package.json to align with main branch.
Removes nativemobile from project template options as it's no longer supported.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Updates @salesforce/templates dependency to incorporate latest fixes
and improvements. Also removes ui-bundle example from CLAUDE.md as
it's now covered by the main template generation docs.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Reverts formatting changes to prevent them from appearing in PR
against upstream main branch.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@deepu-mungamuri94 deepu-mungamuri94 force-pushed the rename-webapp-to-ui-bundle branch from 906c4f0 to 4724392 Compare March 30, 2026 06:02
@iowillhoit iowillhoit merged commit 9e382dc into salesforcecli:main Mar 30, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants