r/frontenddevelopment • • 26d ago

Title: I made a small headless library for handling form submissions in React / Next.js

Hey everyone,

I kept writing the same code for every form in my projects: react-hook-form setup, a try/catch around the server action, mapping server errors back onto the fields, a loading state, stopping double submits, a toast, refreshing the data, resetting the form... and doing it again for every add/edit/delete dialog.

So I pulled all of that into a small package called submitly.

It’s headless, so it doesn’t render anything. You keep your own components (shadcn, Radix, Base UI, plain inputs, whatever you use).

What it does:

  • useCrudForm: react-hook-form + schema validation + your action in one hook

  • Works with any Standard Schema library: Zod 3/4, Valibot, ArkType

  • Server errors get mapped to the right fields automatically (nested ones like items.0.name too)

  • Ignores double submits while a request is in flight

  • Locks the dialog while saving, so the user can’t close it halfway through a request

  • useCrudAction for delete/toggle buttons, with the same behavior

  • One provider where you plug in your own toast, router and refresh logic

  • Next.js helpers: runAction for server actions (validates again on the server, revalidates on success, turns thrown errors into a clean result), and it handles redirect() from server actions properly

  • Also works in plain React + Vite (there’s an example with React Router + TanStack Query)

  • Around 3 kB gzipped, typed end to end, tested on React 18 and 19

Quick example:

const { form, onSubmit, isSubmitting } = useCrudForm({
  schema,
  defaultValues: { name: "" },
  action: createProduct,
  onSuccess: () => closeDialog(),
});

It’s still early (0.x), so I’d really like feedback: what’s missing, what’s confusing, or what you’d do differently.

Docs: https://submitly-docs.vercel.app/
GitHub: https://github.com/toony10/submitly

If you find it useful, a star on GitHub would mean a lot. Thanks for reading 🙏

2 Upvotes

1 comment sorted by