majiayu000 Send Schema Form
Overview
Use SchemaForm as the default form primitive in this repo. Define a zod schema with formFields, derive types via z.infer, and render fields through SchemaForm so validation and UI stay consistent.
Workflow
- Define a zod schema using formFields (text, textarea, number, boolean, select, note, date, etc.).
- Create a form instance with useForm<z.infer>().
- Render SchemaForm with schema, defaultValues, props, and a render function for layout.
- Submit via form.handleSubmit and handle server errors with form.setError on a field.
- Wrap in FormProvider only if child components use useFormContext/useController.
SchemaForm vs Controller
- Prefer SchemaForm + formFields for standard inputs. It wires validation, error display, and UI conventions in one place.
- Use Controller/useFormContext when a field is not supported by formFields or needs custom wiring (composite inputs, third-party components, complex formatting). Keep the field in the schema and validate manually or with a form-level resolver if needed.
- Avoid local state for field values. Let react-hook-form own the field state and use form.watch for derived UI.
Resources
- references/schema-form-example.tsx: example form using SchemaForm, zod, and typed values.
- assets/schema-form-template.tsx: skeleton to copy when starting a new form.