Remix Validated Form

RVF v6 has been released!

For new projects, we recommend starting with v6. For existing projects, there's a migration guide available.

Server validation

One of the core features of this library is that you can re-use your validation on the server. In the last example, we created this validator to use in our form.

export const validator = withZod(
  z.object({
    firstName: z
      .string()
      .min(1, { message: "First name is required" }),
    lastName: z
      .string()
      .min(1, { message: "Last name is required" }),
    email: z
      .string()
      .min(1, { message: "Email is required" })
      .email("Must be a valid email"),
  }),
);

We can re-use this validator in our action like this.

export const action = async ({
  request,
}: DataFunctionArgs) => {
  const result = await validator.validate(
    await request.formData(),
  );

  if (result.error) {
    // validationError comes from `remix-validated-form`
    return validationError(result.error);
  }

  const { firstName, lastName, email } = result.data;
  // Do something with the data
};

When we use the validationError to return our error, the ValidatedForm in our route component will automatically display the errors on the form fields. We pass the original data the user submitted as a second argument to validationError to specify how to repopulate the form if the user has JavaScript disabled. You can read more about this in the API reference for validationError.

Full implementation

If we put everything together, we have a fully working example.