@openmrs/esm-form-engine-lib 3.1.3-pre.1744 → 3.1.3-pre.1747
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 +20 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -146,6 +146,26 @@ You could also optionally proxy to a different backend where your forms are host
|
|
|
146
146
|
yarn start --sources packages/esm-form-engine-app --backend https://link-to-my-backend.com
|
|
147
147
|
```
|
|
148
148
|
|
|
149
|
+
#### Troubleshooting linking issues
|
|
150
|
+
|
|
151
|
+
You might run into dependency version mismatches when attempting to link the library to the consuming frontend module. `@carbon/react` is a common culprit. If you see an error like this in your terminal after running `yarn link`:
|
|
152
|
+
|
|
153
|
+
```sh
|
|
154
|
+
@carbon/react@npm:1.74.0 [5ffd1] conflicts with parent dependency @carbon/react@npm:1.60.3 [faad]
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
That's because the consuming frontend module is using a different version of `@carbon/react` than the Form Engine Lib.
|
|
158
|
+
|
|
159
|
+
To resolve this, you set a `resolutions` field in your consuming frontend module's root `package.json` file to force the use of the same version of `@carbon/react` in the Form Engine Lib.
|
|
160
|
+
|
|
161
|
+
```json
|
|
162
|
+
"resolutions": {
|
|
163
|
+
"@carbon/react": "1.60.3"
|
|
164
|
+
}
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
Once you've added the `resolutions` field, you'll need to run `yarn` again to install the dependencies. After that, you should be able to link the library to the consuming frontend module and run the consuming frontend module without any issues.
|
|
168
|
+
|
|
149
169
|
### Production
|
|
150
170
|
|
|
151
171
|
Note that in addition to this library, other form engine alternatives exist within the O3 ecosystem, including:
|