Context
The owner wants a form builder, drag-and-drop or document style, whose forms embed in any page or component. A separate form format (the Form.io or SurveyJS style) would duplicate versioning, drafts, permissions, validation and security that L2 documents (0110) already have.Decision
- F1 — A built form is a UI document of kind
form, in the same format as pages and dashboards, stored as the form definition content type of 0116. Its schema is stored once and turned into Zod on web, mobile and server. - Forms embed as a block in any page, screen or component.
- F2 — A form submits to an
@Action. The default is the genericforms.submit@1action, which stores the submission; a form may name a domain action instead. Submissions are domain data, not content. - F3 — The drag-and-drop and document-style editors are Pro (
@stackra-pro/form-builder). The form runtime is free.
Consequences
- One format to secure, version and validate; agents and the registry already understand it.
- Submissions run through the action pipeline, so validation, tenancy, approval and audit apply.
- Code-authored forms keep using react-hook-form and Zod (0055); built forms render through the same field adapters.