@opencitylabs/formio-custom-components

Formio Custom Components

Libreria di componenti custom per Form.io, sviluppata con React e pronta per la pubblicazione su npm.

Requisiti

• Node.js 20+
• npm 10+

Installazione

npm install

Sviluppo locale (Playground)

Il progetto include un playground per testare i componenti in locale con Form Builder + Preview.

npm run dev

Apri nel browser:

• http://localhost:5173

Script disponibili

• npm run dev: avvia il playground in modalità sviluppo
• npm run build: build della libreria in dist/
• npm run build:playground: build del playground
• npm run preview: anteprima della build del playground
• npm run clean: pulizia cartelle di output

Output build libreria

La build genera:

• dist/index.js (ESM)
• dist/index.cjs (CommonJS)

Utilizzo della libreria

Esempio di import:

import { registerFormioComponents } from "@opencitylabs/formio-custom-components";
import { Components } from "@formio/js";

registerFormioComponents(Components);

Sono anche esportati:

• formioCustomComponents
• singoli componenti da src/index.js

Pubblicazione su npm

Prima della publish viene eseguita automaticamente la build (prepublishOnly).

npm publish

Struttura principale

• src/: codice della libreria e componenti Form.io
• playground/: ambiente locale di test
• vite.config.js: configurazione Vite (libreria + playground)

Note

Alcuni componenti fanno uso di API esterne o variabili globali (window.BASE_URL, window.OC_SERVICE_DETAILS) nel playground sono valorizzate con fallback minimi per facilitare i test.