Skip to content

redux-form

A React library that stores HTML form state in a Redux store.

Stars
12.5k
Forks
1.6k
Licence
MIT
Language
JavaScript
Last update
2.4 years ago
Type
Library

No commits in over a year — check for forks or alternatives before adopting.

What it is

redux-form is a React library, built as a higher-order component on top of React Redux, that keeps the state of an HTML form inside a Redux store. It is meant for developers who already use Redux and want form values readable and changeable from elsewhere in their app. The README itself recommends most new projects use React Final Form or Formik instead, unless they specifically need tight coupling between form data and Redux.

  • Building a sign-up or checkout form whose values are stored in Redux
  • Adding synchronous or asynchronous validation to form fields, as shown in the README's examples
  • Initializing a form from existing Redux state
  • Building multi-step wizard forms and forms with field arrays, per the README's example list

Great for

  • React developers who already use Redux and want form state in the same store
  • Apps where parts of the UI far from the form (such as another route) need to read or change form values
  • Teams maintaining an existing project that already uses redux-form

Not ideal for

  • Developers starting a new project with no need for form state in Redux; the README recommends React Final Form or Formik instead
  • Non-React projects, since it is built specifically on React and React Redux
  • Beginners who do not yet know React and Redux, since the library assumes both
Step-by-step guide: how to use redux-formInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Install with a package manager

    You'll need: Node.js and npm · React · Redux and React Redux

    Install redux-form with npm

    npm install --save redux-form
  2. 2

    Run it

    • Install React, Redux, and React Redux in your project.
    • Run npm install --save redux-form.
    • Open one of the linked CodeSandbox examples, such as Simple Form, to see a working form.
    • Follow the Getting Started guide on redux-form.com to wire the reducer and a form component into your store.
  3. 3

    Get the most out of it

    • Read the Getting Started guide and API docs on redux-form.com to learn the reducer and Field setup
    • Work through the CodeSandbox examples for validation, field arrays, and wizard forms
    • Check the FAQ on redux-form.com when integrating with Immutable JS, as there is a linked example for it
    • Watch the two linked talks by the author for background on the design

Downloads

Strengths

  • Form state lives in Redux, so it can be inspected and updated from anywhere in the app
  • Includes a documented set of examples covering validation, field arrays, and wizard forms
  • Released under the permissive MIT license

Trade-offs

  • The README says the author now recommends other libraries for most new projects
  • Documentation links point to version 8.2.2 docs, while the latest release is v8.3.10, so docs may lag the release
  • Keeping form state in Redux adds boilerplate compared with lighter form libraries

How it compares

ProjectStarsTypeLevelUpdatedBest for
redux-form (this)12.5kLibraryintermediate2.4 years agoReact developers who already use Redux and want form state in the same store
react-hook-form44.9kLibraryintermediate5 days agoReact developers building forms with several fields
vee-validate11.3kLibraryintermediate8 months agoVue developers who need form validation without writing it from scratch
normalizr20.8kLibraryintermediate4.6 years agoJavaScript developers who receive deeply nested API responses and want flat, ID-keyed data
redux61.4kLibraryintermediate16 days agoDevelopers building larger front-end apps where many components share the same data
zustand58.9kLibrarybeginner15 days agoReact developers who want simpler shared state than Redux

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.