examples: confrom init

apps/example-next-conform/.gitignore

@@ -0,0 +1,36 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

apps/example-next-conform/README.md

@@ -0,0 +1,12 @@
+# Examples next app with conform
+
+## Getting Started
+
+```
+$ pnpm i
+$ pnpm run dev
+```
+
+## Conform
+
+https://conform.guide/integration/nextjs

apps/example-next-conform/app/dynamic-form/action.ts

@@ -0,0 +1,19 @@
+"use server";
+
+import { parseWithZod } from "@conform-to/zod";
+import { redirect } from "next/navigation";
+import { teamSchema } from "./schema";
+
+export async function saveTeam(prevState: unknown, formData: FormData) {
+  const submission = parseWithZod(formData, {
+    schema: teamSchema,
+  });
+
+  if (submission.status !== "success") {
+    return submission.reply();
+  }
+
+  console.log("submit data", submission.value);
+
+  redirect("/success");
+}

apps/example-next-conform/app/dynamic-form/form.tsx

@@ -0,0 +1,71 @@
+"use client";
+
+import { getFormProps, getInputProps, useForm } from "@conform-to/react";
+import { parseWithZod } from "@conform-to/zod";
+import { useFormState } from "react-dom";
+import { saveTeam } from "./action";
+import { teamSchema } from "./schema";
+
+export default function Form() {
+  const [lastResult, action] = useFormState(saveTeam, undefined);
+  const [form, fields] = useForm({
+    lastResult,
+    onValidate({ formData }) {
+      return parseWithZod(formData, { schema: teamSchema });
+    },
+    shouldValidate: "onBlur",
+  });
+  const members = fields.members.getFieldList();
+
+  return (
+    <form {...getFormProps(form)} action={action} noValidate>
+      <button
+        type="submit"
+        {...form.insert.getButtonProps({
+          name: fields.members.name,
+        })}
+      >
+        Add member
+      </button>
+      {members.map((member, index) => {
+        const memberFields = member.getFieldset();
+
+        return (
+          <div key={member.key}>
+            <div>Member {index + 1}</div>
+            <input type="hidden" name={memberFields.id.name} value={index} />
+            <label htmlFor={memberFields.name.id}>
+              name:&nbsp;
+              <input name={memberFields.name.name} />
+            </label>
+            <label>
+              leader:&nbsp;
+              <input
+                {...getInputProps(fields.leaderId, {
+                  type: "radio",
+                  value: index.toString(),
+                })}
+              />
+            </label>
+            <label>
+              engineer:&nbsp;
+              <input name={memberFields.engineer.name} type="checkbox" />
+            </label>
+            <button
+              type="button"
+              {...form.remove.getButtonProps({
+                name: fields.members.name,
+                index,
+              })}
+            >
+              Remove
+            </button>
+            <div>{memberFields.name.errors?.join(", ")}</div>
+            <div>{memberFields.engineer.errors?.join(", ")}</div>
+          </div>
+        );
+      })}
+      <button type="submit">submit</button>
+    </form>
+  );
+}

apps/example-next-conform/app/dynamic-form/page.tsx

@@ -0,0 +1,10 @@
+import Form from "./form";
+
+export default function Page() {
+  return (
+    <main>
+      <h1>Dynamic Form</h1>
+      <Form />
+    </main>
+  );
+}

apps/example-next-conform/app/dynamic-form/schema.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+
+export const teamSchema = z.object({
+  leaderId: z.string({
+    required_error: "Leader is required",
+  }),
+  members: z.array(
+    z.object({
+      id: z.string().min(1),
+      name: z
+        .string({
+          required_error: "Name is required",
+        })
+        .min(1)
+        .max(100),
+      engineer: z.preprocess((x) => x === "on", z.boolean()),
+    }),
+  ),
+});

apps/example-next-conform/app/layout.tsx

@@ -0,0 +1,11 @@
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

apps/example-next-conform/app/page.tsx

@@ -0,0 +1,22 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+
+export const metadata: Metadata = {
+  title: "`conform` example",
+};
+
+export default function Home() {
+  return (
+    <main>
+      <h1>`conform` example</h1>
+      <ul>
+        <li>
+          <Link href="/simple-form">simple-form</Link>
+        </li>
+        <li>
+          <Link href="/dynamic-form">dynamic-form</Link>
+        </li>
+      </ul>
+    </main>
+  );
+}

apps/example-next-conform/app/simple-form/action.ts

@@ -0,0 +1,19 @@
+"use server";
+
+import { parseWithZod } from "@conform-to/zod";
+import { redirect } from "next/navigation";
+import { userSchema } from "./schema";
+
+export async function saveUser(prevState: unknown, formData: FormData) {
+  const submission = parseWithZod(formData, {
+    schema: userSchema,
+  });
+
+  if (submission.status !== "success") {
+    return submission.reply();
+  }
+
+  console.log("submit data", submission.value);
+
+  redirect("/success");
+}

apps/example-next-conform/app/simple-form/form.tsx

@@ -0,0 +1,42 @@
+"use client";
+
+import { getFormProps, getInputProps, useForm } from "@conform-to/react";
+import { parseWithZod } from "@conform-to/zod";
+import { useFormState } from "react-dom";
+import { saveUser } from "./action";
+import { userSchema } from "./schema";
+
+export default function Form() {
+  const [lastResult, action] = useFormState(saveUser, undefined);
+  const [form, fields] = useForm({
+    lastResult,
+    onValidate({ formData }) {
+      return parseWithZod(formData, { schema: userSchema });
+    },
+    shouldValidate: "onBlur",
+  });
+
+  return (
+    <form {...getFormProps(form)} action={action} noValidate>
+      <div>
+        <label htmlFor={fields.firstName.id}>First name</label>
+        <input
+          {...getInputProps(fields.firstName, {
+            type: "text",
+          })}
+        />
+        <div>{fields.firstName.errors}</div>
+      </div>
+      <div>
+        <label htmlFor={fields.lastName.id}>Last name</label>
+        <input
+          {...getInputProps(fields.lastName, {
+            type: "text",
+          })}
+        />
+        <div>{fields.lastName.errors}</div>
+      </div>
+      <button type="submit">Submit</button>
+    </form>
+  );
+}

apps/example-next-conform/app/simple-form/page.tsx

@@ -0,0 +1,10 @@
+import Form from "./form";
+
+export default function Page() {
+  return (
+    <main>
+      <h1>Simple Form</h1>
+      <Form />
+    </main>
+  );
+}

apps/example-next-conform/app/simple-form/schema.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+
+export const userSchema = z.object({
+  firstName: z
+    .string({
+      required_error: "`First name` is required",
+    })
+    .min(1)
+    .max(100),
+  lastName: z
+    .string({
+      required_error: "`Last name` is required",
+    })
+    .min(1)
+    .max(100),
+});

apps/example-next-conform/app/success/page.tsx

@@ -0,0 +1,12 @@
+import Link from "next/link";
+
+export default function Page() {
+  return (
+    <main>
+      <h1>Success!</h1>
+      <p>
+        <Link href="/">top page</Link>
+      </p>
+    </main>
+  );
+}

apps/example-next-conform/package.json

@@ -0,0 +1,22 @@
+{
+  "private": true,
+  "scripts": {
+    "dev": "next dev --turbo",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "@conform-to/react": "1.0.6",
+    "@conform-to/zod": "1.0.6",
+    "next": "14.1.4",
+    "react": "18.2.0",
+    "react-dom": "18.2.0",
+    "zod": "3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "20.11.30",
+    "@types/react": "18.2.67",
+    "@types/react-dom": "18.2.22",
+    "typescript": "5.4.3"
+  }
+}

apps/example-next-conform/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}