@cyprnet/node-red-contrib-uibuilder-formgen

PortalSmith FormGen (uibuilder-formgen)

PortalSmith FormGen is a Node-RED contrib module that generates schema-driven uibuilder portals (HTML/JS) from a JSON schema. It is designed for no-build-step operation: generate → open in browser → submit back to Node-RED.

$3

CyprNet Solutions: https://www.cyprnetsolutions.com

$3

- Schema-driven forms: sections + fields + basic validation
- Export: JSON/CSV/HTML (client-side)
- Draft save/load: browser + file workflows
- Theme + branding: light/dark theme support; logo support (licensed)
- Results page: optional result rendering after HTTP submit

$3

- Node.js: 18+ (20.x recommended)
- Node-RED: 3.1+ (4.x recommended)
- node-red-contrib-uibuilder: v7.x
- Browser: modern Chrome/Firefox/Edge

$3

Install into your Node-RED userDir:

``bash cd ~/.node-red npm install @cyprnet/node-red-contrib-uibuilder-formgen`

Then restart Node-RED.

`$3`

1. Create a uibuilder instance (example URL: form-jobapp) and deploy. 2. Send a schema intouibuilder-formgen (legacy Vue 2) or uibuilder-formgen-v3 (Vue 3) as msg.schema(or use the example flow). 3. Open/uibuilder// in your browser.

`$3`

Generated portals are a 3-file set that must stay together in the uibuilder instance’s served folder:

- src/index.html-src/index.js-src/form.schema.json

If you copy a portal to another uibuilder instance (or commit/restore from git), make sure you copy all three. The portal loads the schema at runtime and will not work correctly if form.schema.json is missing.

`$3`

- uibuilder-formgen (legacy): generates portals using Vue 2 + Bootstrap 4 -uibuilder-formgen-v3: generates portals using Vue 3 + Bootstrap 5

The two portals are intentionally very similar in appearance; the difference is the runtime stack and long-term supportability.

To confirm which node generated a portal, open the generated portalsmith.runtime.jsonand check: -generatorNode: uibuilder-formgen or uibuilder-formgen-v3

`$3`

- Free (default): watermarked portal + default PortalSmith branding. - Licensed (PRO): allows watermark removal and custom branding/logo (if enabled by your license features).

To apply a license, paste the license key provided by CyprNet into the shared portalsmith-license config node and reference it from your uibuilder-formgen nodes. Restart Node-RED after installing/updating the module.

`$3`

- Offline user guide (packaged): docs/user-guide.html- Example flow:examples/portalsmith-formgen-example.json- Industry schemas:examples/schemas/- Schema Builder frontend files (uibuilder v7+):examples/formgen-builder/src/index.html and examples/formgen-builder/src/index.js- Schema Builder frontend files (legacy uibuilder 2.x):examples/formgen-builder-uib2/src/index.html and examples/formgen-builder-uib2/src/index.js

`$3`

MIT. See LICENSE`.

PortalSmith FormGen (uibuilder-formgen)

$3

CyprNet Solutions: https://www.cyprnetsolutions.com

$3

- Node.js: 18+ (20.x recommended)
- Node-RED: 3.1+ (4.x recommended)
- node-red-contrib-uibuilder: v7.x
- Browser: modern Chrome/Firefox/Edge

$3

Install into your Node-RED userDir:

``bash cd ~/.node-red npm install @cyprnet/node-red-contrib-uibuilder-formgen`

Then restart Node-RED.

`$3`

Generated portals are a 3-file set that must stay together in the uibuilder instance’s served folder:

- src/index.html-src/index.js-src/form.schema.json

`$3`

- uibuilder-formgen (legacy): generates portals using Vue 2 + Bootstrap 4 -uibuilder-formgen-v3: generates portals using Vue 3 + Bootstrap 5

The two portals are intentionally very similar in appearance; the difference is the runtime stack and long-term supportability.

To confirm which node generated a portal, open the generated portalsmith.runtime.jsonand check: -generatorNode: uibuilder-formgen or uibuilder-formgen-v3

`$3`

- Free (default): watermarked portal + default PortalSmith branding. - Licensed (PRO): allows watermark removal and custom branding/logo (if enabled by your license features).

`$3`

MIT. See LICENSE`.