@salesforce/webapp-template-app-react-template-b2x-experimental 1.70.0 → 1.71.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +52 -0
- package/dist/CHANGELOG.md +8 -0
- package/dist/force-app/main/default/README.md +72 -0
- package/dist/force-app/main/default/webapplications/appreacttemplateb2x/README.md +35 -0
- package/dist/force-app/main/default/webapplications/appreacttemplateb2x/package.json +3 -3
- package/dist/package.json +1 -1
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# appreacttemplateb2x
|
|
2
|
+
|
|
3
|
+
B2X (Business-to-Consumer) base template app — authentication, global search, and site container for Experience Cloud.
|
|
4
|
+
|
|
5
|
+
## In this monorepo
|
|
6
|
+
|
|
7
|
+
This package is a **template app** in the webapps monorepo. It is built by applying feature patches to the base React app; the output is written to `dist/`.
|
|
8
|
+
|
|
9
|
+
### Build
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
nx run appreacttemplateb2x:build
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Produces an SFDX project in `dist/` with the web app at `dist/force-app/main/default/webapplications/appreacttemplateb2x/`.
|
|
16
|
+
|
|
17
|
+
### Dev server
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
nx run appreacttemplateb2x:dev
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Starts the Vite dev server from the built output in `dist/`.
|
|
24
|
+
|
|
25
|
+
### Watch
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
nx run appreacttemplateb2x:watch
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Re-applies patches automatically when source files change.
|
|
32
|
+
|
|
33
|
+
### Test
|
|
34
|
+
|
|
35
|
+
This package has no dedicated test target. To run tests, build first, then run them from the built web app:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
nx run appreacttemplateb2x:build
|
|
39
|
+
cd dist/force-app/main/default/webapplications/appreacttemplateb2x && npm install && npm test
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Clean
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
npm run clean
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Removes the `dist/` directory.
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
For standalone run, deploy, and test instructions (e.g. after publishing or extracting `dist/`), see the [web app README](dist/force-app/main/default/webapplications/appreacttemplateb2x/README.md).
|
package/dist/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,14 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
# [1.71.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.70.0...v1.71.0) (2026-03-05)
|
|
7
|
+
|
|
8
|
+
**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
6
14
|
# [1.70.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.69.0...v1.70.0) (2026-03-04)
|
|
7
15
|
|
|
8
16
|
**Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# App React Template B2X
|
|
2
|
+
|
|
3
|
+
A B2X (Business-to-Consumer) React starter template for customer-facing apps on the Salesforce platform. Includes authentication, global search, and an Experience Cloud site container. Built with React, Vite, TypeScript, and Tailwind/shadcn.
|
|
4
|
+
|
|
5
|
+
## What's included
|
|
6
|
+
|
|
7
|
+
| Path | Description |
|
|
8
|
+
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
|
|
9
|
+
| `force-app/main/default/webapplications/appreacttemplateb2x/` | React web app (source, config, tests) |
|
|
10
|
+
| `force-app/main/default/classes/` | Apex classes for authentication — `WebAppAuthUtils`, `WebAppChangePassword`, `WebAppForgotPassword`, `WebAppLogin`, `WebAppRegistration` |
|
|
11
|
+
| `force-app/main/default/digitalExperienceConfigs/` | Experience Cloud site configuration |
|
|
12
|
+
| `force-app/main/default/digitalExperiences/` | Experience Cloud site definition |
|
|
13
|
+
| `force-app/main/default/networks/` | Experience Cloud network |
|
|
14
|
+
| `force-app/main/default/sites/` | Salesforce site |
|
|
15
|
+
|
|
16
|
+
## Getting started
|
|
17
|
+
|
|
18
|
+
Navigate to the web app and install dependencies:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
cd force-app/main/default/webapplications/appreacttemplateb2x
|
|
22
|
+
npm install
|
|
23
|
+
npm run dev
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Opens at http://localhost:5173 by default. For build and test instructions, see the [web app README](force-app/main/default/webapplications/appreacttemplateb2x/README.md).
|
|
27
|
+
|
|
28
|
+
## Deploy
|
|
29
|
+
|
|
30
|
+
### Deploy everything (metadata + Experience Cloud site + web app)
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
cd force-app/main/default/webapplications/appreacttemplateb2x && npm install && npm run build && cd -
|
|
34
|
+
sf project deploy start --source-dir force-app --target-org <alias>
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### Deploy the web app only
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
cd force-app/main/default/webapplications/appreacttemplateb2x && npm install && npm run build && cd -
|
|
41
|
+
sf project deploy start --source-dir force-app/main/default/webapplications --target-org <alias>
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
### Deploy Experience Cloud site only
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
sf project deploy start \
|
|
48
|
+
--source-dir force-app/main/default/digitalExperienceConfigs \
|
|
49
|
+
--source-dir force-app/main/default/digitalExperiences \
|
|
50
|
+
--source-dir force-app/main/default/networks \
|
|
51
|
+
--source-dir force-app/main/default/sites \
|
|
52
|
+
--target-org <alias>
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### Deploy authentication classes only
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
sf project deploy start --source-dir force-app/main/default/classes --target-org <alias>
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Replace `<alias>` with your target org alias.
|
|
62
|
+
|
|
63
|
+
## Configure Your Salesforce DX Project
|
|
64
|
+
|
|
65
|
+
The `sfdx-project.json` file contains useful configuration information for your project. See [Salesforce DX Project Configuration](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_config.htm) in the _Salesforce DX Developer Guide_ for details about this file.
|
|
66
|
+
|
|
67
|
+
## Read All About It
|
|
68
|
+
|
|
69
|
+
- [Salesforce Extensions Documentation](https://developer.salesforce.com/tools/vscode/)
|
|
70
|
+
- [Salesforce CLI Setup Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm)
|
|
71
|
+
- [Salesforce DX Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_intro.htm)
|
|
72
|
+
- [Salesforce CLI Command Reference](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference.htm)
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# App React Template B2X
|
|
2
|
+
|
|
3
|
+
A B2X (Business-to-Consumer) React template for customer-facing apps on the Salesforce platform. Includes authentication, global search, and an Experience Cloud site container. Built with React, Vite, TypeScript, and Tailwind/shadcn.
|
|
4
|
+
|
|
5
|
+
For project-level details (metadata, deploy), see the [project README](../../../../../../README.md).
|
|
6
|
+
|
|
7
|
+
## Prerequisites
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Run (development)
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm run dev
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Starts the Vite dev server (default: http://localhost:5173).
|
|
20
|
+
|
|
21
|
+
## Build
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npm run build
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Writes the production bundle to `dist/` inside the web app folder.
|
|
28
|
+
|
|
29
|
+
## Test
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
npm test
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Runs the unit test suite (Vitest).
|
|
@@ -15,8 +15,8 @@
|
|
|
15
15
|
"graphql:schema": "node scripts/get-graphql-schema.mjs"
|
|
16
16
|
},
|
|
17
17
|
"dependencies": {
|
|
18
|
-
"@salesforce/sdk-data": "^1.
|
|
19
|
-
"@salesforce/webapp-experimental": "^1.
|
|
18
|
+
"@salesforce/sdk-data": "^1.71.0",
|
|
19
|
+
"@salesforce/webapp-experimental": "^1.71.0",
|
|
20
20
|
"@tailwindcss/vite": "^4.1.17",
|
|
21
21
|
"@tanstack/react-form": "^1.28.4",
|
|
22
22
|
"class-variance-authority": "^0.7.1",
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
"@graphql-eslint/eslint-plugin": "^4.1.0",
|
|
41
41
|
"@graphql-tools/utils": "^11.0.0",
|
|
42
42
|
"@playwright/test": "^1.49.0",
|
|
43
|
-
"@salesforce/vite-plugin-webapp-experimental": "^1.
|
|
43
|
+
"@salesforce/vite-plugin-webapp-experimental": "^1.71.0",
|
|
44
44
|
"@testing-library/jest-dom": "^6.6.3",
|
|
45
45
|
"@testing-library/react": "^16.1.0",
|
|
46
46
|
"@testing-library/user-event": "^14.5.2",
|
package/dist/package.json
CHANGED