mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-07-30 03:09:50 +08:00
92cae58d5f
* chore: rename webapp-template packages to ui-bundle-template * chore: sync React b2e and b2x samples from npm @1.117.3 * chore: rename sample folders to match ui-bundle-template package names * chore: sync React b2e and b2x samples from npm @1.117.5 * chore: remove accidental trace.md from b2e sample * chore: keep old webapp-template sample directories alongside new ui-bundle-template ones * chore: revert component.md change from skills/generating-webapplication-ui * chore: update ui-bundle-template sample versions to 1.117.5
55 lines
3.0 KiB
Markdown
55 lines
3.0 KiB
Markdown
# Samples
|
|
|
|
Sample apps and templates synced into this repo for reference and reuse.
|
|
|
|
## ui-bundle-template-app-react-sample-b2e
|
|
|
|
Source is synced from the npm package [@salesforce/ui-bundle-template-app-react-sample-b2e](https://www.npmjs.com/package/@salesforce/ui-bundle-template-app-react-sample-b2e). Only the package's source (no `node_modules`) is copied into `samples/ui-bundle-template-app-react-sample-b2e/`.
|
|
|
|
### How it's updated
|
|
|
|
- **GitHub Action**: Runs nightly and can be triggered manually from the **Actions** tab ("Sync React samples from npm"). The workflow runs the same steps as below and opens a PR against `main` only when the npm package version has changed.
|
|
- **Local**: From the **repo root** you can run the same sync anytime:
|
|
|
|
```bash
|
|
npm install
|
|
npm run sync-react-b2e-sample
|
|
```
|
|
|
|
This installs the package into root `node_modules` and copies its source into `samples/ui-bundle-template-app-react-sample-b2e/`, and updates `.version` in that folder.
|
|
|
|
### Version tracking
|
|
|
|
The file `samples/ui-bundle-template-app-react-sample-b2e/.version` stores the last-synced npm version. The Action compares it to the latest on npm and only creates a PR when they differ.
|
|
|
|
## ui-bundle-template-app-react-sample-b2x
|
|
|
|
Source is synced from the npm package [@salesforce/ui-bundle-template-app-react-sample-b2x](https://www.npmjs.com/package/@salesforce/ui-bundle-template-app-react-sample-b2x). Only the package's source (no `node_modules`) is copied into `samples/ui-bundle-template-app-react-sample-b2x/`.
|
|
|
|
### How it's updated
|
|
|
|
- **GitHub Action**: Runs nightly and can be triggered manually from the **Actions** tab ("Sync React samples from npm"). The workflow runs the same steps as below and opens a PR against `main` only when the npm package version has changed.
|
|
- **Local**: From the **repo root** you can run the same sync anytime:
|
|
|
|
```bash
|
|
npm install
|
|
npm run sync-react-b2x-sample
|
|
```
|
|
|
|
This installs the package into root `node_modules` and copies its source into `samples/ui-bundle-template-app-react-sample-b2x/`, and updates `.version` in that folder.
|
|
|
|
### Version tracking
|
|
|
|
The file `samples/ui-bundle-template-app-react-sample-b2x/.version` stores the last-synced npm version. The Action compares it to the latest on npm and only creates a PR when they differ.
|
|
|
|
## native-mobile-rental-tenant-app
|
|
|
|
A sample Custom Agentic Mobile App (CAMA) for rental property tenants. This sample is maintained directly in this repository (not synced from npm). It includes:
|
|
|
|
- **digitalExperiences** metadata: CAMA app config (`experience__camaAppMetadata`), build metadata (`experience__camaBuildMetadata`), EC definition (`experience__camaECDefinition`), and screens (`experience__camaScreen`) with tabs (Home, Tenants, Properties), theme, and toolbar settings
|
|
- **Source**: Synced from [cama-mcp-server](https://git.soma.salesforce.com/khawkins/cama-mcp-server) (branch `apply_metadata_updates`)
|
|
|
|
### How it's used
|
|
|
|
The sample appears on the Agentforce Vibes welcome page under the **Mobile** app type. Users can clone it via the welcome page wizard or directly from this repo.
|