blockmatic/basilic-skills

w-form

Build a Next.js form using the app's existing mutation path, not a second stack.

Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Implement a form in the current Next app. Follow next-v16 and shadcn-v3. If the app already mutates through an API client (Fastify + TanStack Query), do not introduce Server Actions, useFormStatus, or useOptimistic for those flows.

Inspect how neighboring forms submit. Reuse that path.
Share one Zod schema for client UX and server validation.
Wire accessible labels, errors, pending, and empty/error/success states with existing UI primitives.
Run lint and exercise submit, validation failure, and keyboard path.
Docs: /w-docs if behavior or commands changed.