Next.jsnext-jsserver-actionszodformsvalidationproduction-ready

Server Action Form with Zod Validation

Type-safe Next.js server action with Zod schema validation, error handling, and a progressive enhancement form component.

"use server";

import { z } from "zod";

const ContactSchema = z.object({
  name: z.string().min(2, "Name must be at least 2 characters"),
  email: z.string().email("Please enter a valid email address"),
  message: z.string().min(10, "Message must be at least 10 characters").max(1000),
  priority: z.enum(["low", "medium", "high"]).default("medium"),
});

export type ContactFormState = {
  success: boolean;
  message: string;
  errors?: Record<string, string[]>;
};

export async function submitContactForm(
  _prevState: ContactFormState,
  formData: FormData
): Promise<ContactFormState> {
  const raw = {
    name: formData.get("name"),
    email: formData.get("email"),
    message: formData.get("message"),
    priority: formData.get("priority"),
  };

  const result = ContactSchema.safeParse(raw);

  if (!result.success) {
    return {
      success: false,
      message: "Validation failed. Please check the form fields.",
      errors: result.error.flatten().fieldErrors,
    };
  }

  try {
    // Replace with your actual data persistence logic
    await saveContact(result.data);

    return {
      success: true,
      message: "Thank you! Your message has been sent.",
    };
  } catch {
    return {
      success: false,
      message: "Something went wrong. Please try again.",
    };
  }
}

async function saveContact(data: z.infer<typeof ContactSchema>) {
  // Simulate async operation
  await new Promise((resolve) => setTimeout(resolve, 1000));
  console.log("Contact saved:", data);
}

title: "Server Action Form with Zod Validation" description: "Type-safe Next.js server action with Zod schema validation, error handling, and a progressive enhancement form component." category: "Next.js" language: "typescript" tags: ["next-js", "server-actions", "zod", "forms", "validation", "production-ready"] createdAt: "2024-12-10" updatedAt: "2025-01-15"

Overview

Server actions in Next.js provide a seamless way to handle form submissions without writing API routes. Combined with Zod for validation, you get end-to-end type safety from the form to the server. This pattern uses useActionState (React 19) for managing form state and supports progressive enhancement, meaning the form works even without JavaScript.

Code

"use server";
 
import { z } from "zod";
 
const ContactSchema = z.object({
  name: z.string().min(2, "Name must be at least 2 characters"),
  email: z.string().email("Please enter a valid email address"),
  message: z.string().min(10, "Message must be at least 10 characters").max(1000),
  priority: z.enum(["low", "medium", "high"]).default("medium"),
});
 
export type ContactFormState = {
  success: boolean;
  message: string;
  errors?: Record<string, string[]>;
};
 
export async function submitContactForm(
  _prevState: ContactFormState,
  formData: FormData
): Promise<ContactFormState> {
  const raw = {
    name: formData.get("name"),
    email: formData.get("email"),
    message: formData.get("message"),
    priority: formData.get("priority"),
  };
 
  const result = ContactSchema.safeParse(raw);
 
  if (!result.success) {
    return {
      success: false,
      message: "Validation failed. Please check the form fields.",
      errors: result.error.flatten().fieldErrors,
    };
  }
 
  try {
    await saveContact(result.data);
    return { success: true, message: "Thank you! Your message has been sent." };
  } catch {
    return { success: false, message: "Something went wrong. Please try again." };
  }
}

Form Component

"use client";
 
import { useActionState } from "react";
import { submitContactForm, type ContactFormState } from "./actions";
 
const initialState: ContactFormState = { success: false, message: "" };
 
export function ContactForm() {
  const [state, formAction, isPending] = useActionState(
    submitContactForm,
    initialState
  );
 
  return (
    <form action={formAction} className="space-y-4">
      {state.message && (
        <div role="alert" className={state.success ? "text-green-600" : "text-red-600"}>
          {state.message}
        </div>
      )}
 
      <div>
        <label htmlFor="name">Name</label>
        <input id="name" name="name" type="text" required minLength={2} />
        {state.errors?.name && <p className="text-red-500">{state.errors.name[0]}</p>}
      </div>
 
      <button type="submit" disabled={isPending}>
        {isPending ? "Sending..." : "Send Message"}
      </button>
    </form>
  );
}

Notes

  • Server actions run exclusively on the server, so secrets and database connections are safe
  • The useActionState hook replaces the older useFormState from React 18
  • Add minLength, required, and type attributes for HTML validation as a first layer of defense
  • Zod validation runs server-side as a second layer, catching anything that bypasses client validation
  • The _prevState parameter is required by the action signature but you can ignore it if you do not need form state continuity
  • For file uploads, use formData.get("file") and validate with z.instanceof(File)