redux 3.0.0

  • Readme
  • Changelog
  • Installing
  • 81

redux.dart #

Build Status

Redux for Dart using generics for typed State. It includes a rich ecosystem of Docs, Middleware, Dev Tools and can be combined with Flutter using the flutter_redux package.

Redux 3.0.0 Migration & Dart 2 support

In order to support Dart 2, some of the APIs needed to change. The good news: This actually simplifies Redux! The bad news: you may need to update your projects.

  • Change ReducerBinding to TypedReducer
  • Remove combineTypedReducer. Use combineReducers with a combination of normal reducers and/or TypedReducers.
  • Change MiddlewareBinding to TypedMiddleware.
  • Remove combineTypedMiddleware -- no longer needed! Just create a normal List<Middleware<State>>!

Usage #

import 'package:redux/redux.dart';

// Create typed actions. You will dispatch these in order to
// update the state of your application.
enum Actions {

// Create a Reducer. A reducer is a pure function that takes the 
// current State (int) and the Action that was dispatched. It should
// combine the two into a new state without mutating the state passed
// in! After the state is updated, the store will emit the update to 
// the `onChange` stream.
// Because reducers are pure functions, they should not perform any 
// side-effects, such as making an HTTP request or logging messages
// to a console. For that, use Middleware.
int counterReducer(int state, action) {
  if (action == Actions.increment) {
    return state + 1;
  } else if (action == Actions.decrement) {
    return state - 1;
  return state;

// A piece of middleware that will log all actions with a timestamp
// to your console!
// Note, this is just an example of how to write your own Middleware.
// See the redux_logging package on pub for a pre-built logging 
// middleware.
loggingMiddleware(Store<int> store, action, NextDispatcher next) {
  print('${new}: $action');


main() {
  // Create the store with our Reducer and Middleware
  final store = new Store<int>(
    initialState: 0, 
    middleware: [loggingMiddleware],

  // Render our State right away
  // Listen to store changes, and re-render when the state is updated

  // Attach a click handler to a button. When clicked, the `INCREMENT` action
  // will be dispatched. It will then run through the reducer, updating the 
  // state.
  // After the state changes, the html will be re-rendered by our `onChange`
  // listener above. 
  querySelector('#increment').onClick.listen((_) {

render(int state) {
  querySelector('#value').innerHtml = '${state}';

Docs #

  • Motivation and Principles - Learn why Redux might make sense for your app and the principles behind it.
  • Basics - Introduction to the core concepts in Redux
  • Combining Reducers - combineReducers works a bit differently in Dart than it does in JS. Learn why, and how to combine reducers in a type-safe way!
  • Async with Middleware - Learn how to make async calls, such as to a web service or local database, with Redux.
  • API Documentation - Rich documentation included in the source code and generated by DartDoc.

Flutter Examples #

Web Examples #

See the example/ directory for a few simple examples of the basics of Redux.

To launch the examples in your browser:

  1. Run pub serve example from this directory
  2. Open http://localhost:8080

Middleware #

  • redux_logging - Connects a Logger to a Store, and can print out actions as they're dispatched to your console.
  • redux_thunk - Allows you to dispatch functions that perform async work as actions.
  • redux_future - For handling Dart Futures that are dispatched as Actions.
  • redux_epics - Middleware that allows you to work with Dart Streams of Actions to perform async work.

Dev Tools #

The redux_dev_tools library allows you to create a DevToolsStore during dev mode in place of a normal Redux Store.

This DevToolsStore will act exactly like a normal Store at first. However, it will also allow you to travel back and forth throughout the States of your app or recompute the State of your app by replaying all actions through your reducers. This works perfectly with Hot Reloading!

You can combine the DevToolsStore with your own UI to travel in time, or use one of the existing options for the platform you're working with:

Additional Utilities #

  • reselect - Efficiently derive data from your Redux Store with memoized functions.

3.0.0 #

  • Dart 2 support
  • Remove ReducerBinding, use TypedReducer
  • Remove combineTypedReducer. Use combineReducers with normal reducers & TypedReducers.
  • Remove MiddlewareBinding, use TypedMiddleware.
  • Remove combineTypedMiddleware -- no longer needed! Just create a normal List<Middleware<State>>!

2.1.1 #

  • Ensure the repo is 100% healthy.

2.1.0 #

  • Add the distinct option. If set to true, the Store will not emit onChange events if the new State that is returned from your [reducer] in response to an Action is equal to the previous state. False by default.

2.0.4 #

  • Use absolute urls to fix broken links in documentation on Pub.

2.0.3 #

  • Add MOAR documentation

2.0.2 #

  • Add type-safe combineTypedReducers and combineTypedMiddleware functions

2.0.1 #

  • Add documentation highlighting the redux ecosystem

2.0.0 #

  • Breaking API Changes:
    • Reducer is now a typedef. Use ReducerClass<State> if you'd like to continue to use a class interface.
    • Middleware is now a typedef. Use MiddlewareClass<State> as a replacement for the old Middleware<State, Action>
    • A teardown method has been added. Use it to shut down the store in the middle of your application lifecycle if you no longer need the store.
  • Added more docs

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  redux: ^3.0.0

2. Install it

You can install packages from the command line:

with pub:

$ pub get

with Flutter:

$ flutter pub get

Alternatively, your editor might support pub get or flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:redux/redux.dart';
Describes how popular the package is relative to other packages. [more]
Code health derived from static analysis. [more]
Reflects how tidy and up-to-date the package is. [more]
Weighted score of the above. [more]
Learn more about scoring.

We analyzed this package on Nov 22, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.6.0
  • pana: 0.12.21


Detected platforms: Flutter, web, other

No platform restriction found in primary library package:redux/redux.dart.

Health suggestions

Fix lib/src/store.dart. (-1.49 points)

Analysis of lib/src/store.dart reported 3 hints:

line 166 col 20: Use = to separate a named parameter from its default value.

line 174 col 18: Use = to separate a named parameter from its default value.

line 176 col 29: Unnecessary new keyword.

Maintenance suggestions

Package is getting outdated. (-64.66 points)

The package was last published 85 weeks ago.

The package description is too short. (-20 points)

Add more detail to the description field of pubspec.yaml. Use 60 to 180 characters to describe the package, what it does, and its target use case.

Homepage URL is insecure. (-5 points)

Update the homepage field and use a secure (https) URL.

Maintain an example.

None of the files in the package's example/ directory matches known example patterns.

Common filename patterns include main.dart, example.dart, and redux.dart. Packages with multiple examples should provide example/

For more information see the pub package layout conventions.


Package Constraint Resolved Available
Direct dependencies
Dart SDK >=1.24.0 <3.0.0
Dev dependencies
browser >=0.10.0+2 <0.11.0
test >=0.12.24+2 <0.13.0