form0-react

React bindings for form0, the open-source schema-driven form ecosystem by paqu.io. Hooks and components that render a JSON form schema with your own design system.

Source

npm

Version: 0.1.30

Version published: last month

Weekly downloads: 40

Maintainers: 1

Weekly downloads

Created: last year

Source

form0-react

NPM License NPM Last Update

[!WARNING] form0 is in active, very early development. Do not use in production. Expect breaking changes and unstable behavior.

form0-react is the React UI layer of the form0 ecosystem, wrapping the form0-core engine with React bindings and a lightweight set of default field renderers. It ships minimal, accessible HTML components so downstream apps can layer their own design systems on top without rewriting engine integration code.

🗂️ Documentation

[!WARNING] 🚧 Work in progress...

Requirements

Node.js 18+
Worker mode expects a bundler/runtime that supports ESM module workers and rewrites new Worker(new URL('./engine-worker.js', import.meta.url), { type: 'module' }). Vite-based apps are supported. If a consumer has custom worker infrastructure, the internal hooks also accept workerUrl or createWorker overrides through engine options.

Consumer-owned renderer UI

FormRenderer supports consumer-owned state without coupling the renderer to a domain:

headerAccessory accepts a React node or a render function receiving the live { mode: 'edit' | 'readonly' }. It renders at full width after the sticky summary and before the form body.
externalDirty includes consumer-owned changes in modal and spotlight discard confirmation.
submitBlockedReason disables header submission and guards native form submission while the reason is set.
A recordMetadataFields descriptor may include displayValue for read-only display data that must never enter engine values, snapshots, or submitted form values.