TanStack Form v1 Core Features

Agent Workflow (MANDATORY)

TeamCreate

1. fuse-ai-pilot:explore-codebase - Analyze existing form components and validation patterns
2. fuse-ai-pilot:research-expert - Verify latest TanStack Form v1 docs via Context7/Exa
3. mcp__context7__query-docs - Check Zod validation and React 19 Server Actions patterns

MANDATORY: SOLID Principles

solid-react

../solid-react/SKILL.md

• Files < 100 lines (split at 90)
• Interfaces in

  modules/[feature]/src/interfaces/

• JSDoc mandatory on all exports
• No business logic in components

Core Hooks

useForm()

references/tanstack-form-basics.md

useField()

references/tanstack-form-basics.md

form.Field

references/tanstack-form-basics.md

form.Subscribe

references/tanstack-form-basics.md

references/tanstack-form-basics.md

Validation Adapters

zodValidator()

yupValidator()

valibotValidator()

references/zod-validation.md

references/yup-valibot.md

Key Features

Async Validation

references/async-validation.md

Server Actions (React 19)

references/server-actions.md

Arrays & Nested Fields

references/arrays-nested.md

TypeScript Integration

references/typescript.md

shadcn/ui Integration

references/shadcn-integration.md

Listeners (Side Effects)

references/listeners.md

Linked Fields

references/linked-fields.md

Reactivity & Performance

references/reactivity.md

Reset API

references/reset-api.md

SSR & Hydration

references/ssr-hydration.md

Devtools

references/devtools.md

React Native

references/react-native.md

Standard Schema

references/standard-schema.md

Templates

templates/basic-form.md

templates/multi-step-form.md

templates/dynamic-fields.md

templates/file-upload-form.md

templates/server-action-form.md

templates/optimistic-form.md

templates/nested-form.md

templates/search-form.md

templates/conditional-fields.md

templates/form-composition.md

templates/listeners-form.md

templates/linked-fields-form.md

templates/reactivity-form.md

templates/reset-form.md

templates/ssr-form.md

templates/devtools-form.md

templates/react-native-form.md

Best Practices

1. Validation: Use Zod/Yup/Valibot, NOT custom regex
2. Async: Debounce server validation (300-500ms)
3. Errors: Display

   field.state.meta.errors

4. Nested: Use dot notation (

   address.street

   )
5. Arrays: Use

   mode="array"

   with pushValue/removeValue
6. TypeScript: Infer types with

   z.infer<typeof schema>

Forbidden (Anti-Patterns)

• ❌

  useState

  for form state → use

  useForm()

• ❌ Regex validation → use Zod/Yup/Valibot
• ❌ No debounce on async → use

  onChangeAsyncDebounceMs

• ❌ Validation in components → move to schema
• ❌ Direct

  onChange

  → use

  field.handleChange

• ❌ No TypeScript types → use

  z.infer<typeof schema>