whatisgithub

What is redux-promise?

skevy/redux-promise — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2015-11-09

JavaScriptAudience · developerComplexity · 2/5DormantSetup · easy

In one sentence

redux-promise is Redux middleware that lets you dispatch actions containing promises, automatically handling API calls and updating your app's state when they succeed or fail.

Mindmap

mindmap
  root((redux-promise))
    What it does
      Handles promise actions
      Auto dispatches success or error
      Returns promise to caller
    Tech stack
      JavaScript
      Redux
      FSA standard
    Use cases
      Fetch API data into state
      Simplify async action creators
      Server-side rendering data loading
    Audience
      Web app developers
    Ecosystem
      Works with redux-actions
      Flux Standard Action compatible

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Dispatch an action that wraps an API call and let the middleware update state automatically on success or failure.

USE CASE 2

Simplify action creators by wrapping API functions directly instead of writing manual promise handling.

USE CASE 3

Wait for all async data to resolve before rendering HTML on the server.

What is it built with?

JavaScriptRedux

How does it compare?

skevy/redux-promisea15n/a15na15n/checkout-validation
LanguageJavaScriptJavaScriptJavaScript
Last pushed2015-11-092019-04-072014-09-04
MaintenanceDormantDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

So what is it?

Redux-promise is a plugin for Redux, the popular JavaScript state management library, that makes it easy to handle asynchronous operations like API calls. When you're building a web app, you often need to fetch data from a server, and that takes time. This middleware lets you dispatch actions that contain promises, and it automatically handles waiting for the result and updating your app's state once the data arrives. Here's how it works at a high level: you install the middleware into your Redux setup, then when you dispatch an action that contains a promise (the JavaScript way of handling async work), the middleware intercepts it. Once the promise finishes, either successfully or with an error, the middleware automatically dispatches a new action with the result. If the operation succeeds, it includes the resolved data and marks the action's status as "success." If it fails, it includes the error and marks the status as "error." The middleware also returns a promise back to whoever called it, so they can wait for the operation to finish before moving on. This is particularly useful for developers building web apps that need to communicate with servers. For example, if you're fetching a user's profile from an API, you'd wrap that API call in an action creator, dispatch it, and the middleware handles all the waiting and state updates for you automatically. The README shows practical examples like creating action creators that directly wrap API functions, so instead of writing boilerplate code to handle promise resolution and error cases, you just pass your API function to an action creator and the middleware takes it from there. One advantage this library has is that it follows a standard called FSA (Flux Standard Action), which is a consistent way of structuring actions. This makes it compatible with other Redux tools in the same ecosystem, like redux-actions, which further simplifies writing action creators. The library also returns promises to the caller, which is especially helpful for server-side rendering scenarios where you need to wait for all data to load before sending the initial HTML to the browser.

Copy-paste prompts

Prompt 1
Show me how to add redux-promise middleware to my Redux store setup.
Prompt 2
Help me write an action creator that wraps an API call using redux-promise.
Prompt 3
Explain how redux-promise's success and error actions work with FSA-style actions.
Prompt 4
How do I combine redux-promise with redux-actions to simplify async action creators?

Frequently asked questions

What is redux-promise?

redux-promise is Redux middleware that lets you dispatch actions containing promises, automatically handling API calls and updating your app's state when they succeed or fail.

What language is redux-promise written in?

Mainly JavaScript. The stack also includes JavaScript, Redux.

Is redux-promise actively maintained?

Dormant — no commits in 2+ years (last push 2015-11-09).

How hard is redux-promise to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is redux-promise for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.