Aura form guardrails

Installation

pnpm dlx shadcn@latest add @aura/rule-components-forms

Forms use useFormDynamic for state, Form for error distribution, and validateFormData from @/utils/web-validation. Schema property names must match field names so errors match by instancePath.

• MUST: Build forms with useFormDynamic(initialValues, formRef?) and pass fields from getFields() / field(name) into Form field components.
• MUST: Validate with validateFormData(schema, formData.getValues()) and pass returned errors to <Form>. On failure call formData.touchForm().
• MUST: Use Form field components (FormField, FormSwitch, FormCheckbox, groups) per control type; do not pass errors into each field.
• MUST: Keep editable controls ≥ 17px (see typography guardrails). Do not override control padding via call-site className.
• SHOULD: Use FormAlert for form-level errors when fetchStatus === "error".

Procedures and full submit examples live in skill aura-forms.