Troubleshooting SuperForm
Typed schemas and reactive form helpers for React.
Troubleshooting SuperForm
Use these checks to diagnose the most common setup and integration problems.
Module not found: check that installation completed and that imports use the documented /core and /react subpaths.
React hook errors in Next.js: components using useForm are interactive and must be placed behind a client boundary (for example, add the use client directive to the form component).
Input errors never appear: verify that register("email") matches a field in the schema and that the form uses handleSubmit from the same useForm call.
Submission is rejected unexpectedly: inspect the field-level errors and verify the submitted values meet every chained schema rule. Keep authoritative validation on your server as well.