unstale

npm / @tanstack/react-form

@tanstack/react-form

What changed in @tanstack/react-form 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-13.

4 breaking4 new APIs and options2 behavior and defaults15 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.3.0 on npm

@tanstack/react-form 125 changes

Breaking changes 4

  • Errors are flattened consistently when form.validate() runs before a field mounts; flattening is enabled by default unless disableErrorFlat is true.

    1.28.0release notes

  • The Next.js adapter was extracted to this library.

    1.25.0release notes

  • The Remix adapter was extracted to this library.

    1.25.0release notes

  • The Start adapter was extracted to this library and updated to Release Candidate version.

    1.25.0release notes

New APIs and options 4

  • Re-exported from the TanStack Store adapters so developers can use it through those adapters.

    1.33.1release notes

  • Added the FormGroup API.

    1.33.0release notes

  • Adds an extension method to AppForm so teams can extend upstream AppForms.

    1.29.0release notes

  • Adds useTypedAppFormContext for accessing typed app form context.

    1.28.0release notes

Behavior and default changes 2

  • Form ID generation uses React 18's useId by default, with Math.random() as a fallback if no formId is provided.

    1.27.2release notes

  • The render function can now return any ReactNode, not just JSX.Element.

    1.23.8release notes

Fixes and other changes 15

  • Uses a fresh FieldApi in the current render when the field name changes.

    1.33.2release notes

  • Arrays now re-render when their values change even if their length stays the same.

    1.32.0release notes

  • Fixed field unmount behavior.

    1.28.6release notes

  • The fallback selector for the Subscribe component was reimplemented.

    1.28.5release notes

  • The withForm HOC now returns a named function to enable Fast Refresh.

    1.28.5release notes

  • Form arrays work again.

    1.28.3release notes

  • Fixed various SSR issues so things work as expected in more scenarios.

    1.28.1release notes

  • Fixed a compile error with webpack when using React v17.

    1.28.1release notes

  • Array fields with mode="array" now re-render only when the array length changes, not when individual item properties are modified.

    1.27.4release notes

  • FormApi.handleSubmit returns a promise again.

    1.27.2release notes

  • Fixes issues with methods not being present in the React adapter.

    1.27.1release notes

  • Removed useId and replaced it with uuid for React 17 user compatibility.

    1.27.0release notes

  • Fixed issues with React Compiler.

    1.27.0release notes

  • Performance was minorly improved and issues with Start were fixed.

    1.27.0release notes

  • The props type now allows interfaces to be assigned to it.

    1.23.8release notes