Developer guides
SuperForm

Troubleshooting SuperForm

Typed schemas and reactive form helpers for React.

SUPERFORM · COMMON ERRORS

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.