Repository files navigation

Please note that this repo has been deprecated. Code and issues are being migrated to a monorepo athttps://github.com/angular-redux/platform where we are beginning work on a new and improved v10. To file any new issues or see the state of the current code base, we would love to see you there! Thanks for your support!

@angular-redux/store@^9 is what you need. This consumes breaking changes from RxJS and Angular 6, as well as updated typedefs from Redux 4.

Use@angular-redux/store@^7 - this version supports Angular 5, and also changes to using lettable operators.

Use@angular-redux/store@^6 - This supports Angular 4 and earlier.

Where possible, I will be maintaining and applying any fixes / enhancements for v7 into v6 where it does not introduce a breaking change.

I made a few mistakes trying to publish fixes / etc to two major versions, which caused some releases to get tagged incorrectly and caused some confusion. Sorry for any confusion this has caused, and will do better on avoiding this in the future, and being more transparent with the releases that are going out.

Angular bindings forRedux.

For Angular 1 seeng-redux

Redux is a popular approach to managing state in applications. It emphasises:

• A single, immutable data store.
• One-way data flow.
• An approach to change based on pure functions and a stream of actions.

You can find lots of excellent documentation here:Redux.

We provide a set of npm packages that help you integrate your redux storeinto your Angular 2+ applications. Our approach helps you by bridging the gapwith some of Angular's advanced features, including:

• Change processing with RxJS observables.
• Compile time optimizations withNgModule and Ahead-of-Time compilation.
• Integration with the Angular change detector.

• I already know what Redux and RxJS are.Give me the TL;DR.
• I'm just learning about Redux.Break it down for me!
• Talk is cheap.Show me a complete code example.
• Take me to theAPI docs.

Here are some examples of theangular-redux family of packages in action:

• Zoo Animals Combined Example App
• Simple SystemJS Example (Angular Quickstart)

• Reduxify your Routing with @angular-redux/router
• Reduxify your Forms with @angular-redux/form

• Using Redux with Angular - JS Toronto Meetup 2016-07-12
• Getting started with Redux
• Awesome Redux: Community Resources

@angular-redux/store uses an approach to redux based on RxJS Observables toselect and transformdata on its way out of the store and into your UI or side-effect handlers. Observablesare an efficient analogue toreselect for the RxJS-heavy Angular world.

Read more here:Select Pattern

We also have a number of 'cookbooks' for specific Angular topics:

• Using Angular's Dependency Injector with Action Creators
• Using Angular's Dependency Injector with Middlewares
• Managing Side-Effects with redux-observable Epics
• Using the Redux DevTools Chrome Extension
• @angular-redux/store and ImmutableJS
• Strongly Typed Reducers

Want to hack on angular-redux/store or any of the related packages? Feel free to do so, but please test your changes before making any PRs.

Here's how to do that:

1. Write unit tests. You can check that they work by runningnpm test.
2. Run the linter. If your editor doesn't do it automatically, do itmanually withnpm run lint.
3. Test your changes in a 'real world scenario'. We use theexample-app for this, using some npmfakery to 'publish the package locally':

• clone the example app (git clone https://github.com/angular-redux/example-app.git)
• generate a 'local package' (cd to yourangular-redux/store clone and runnpm pack). This will create a.tgz file.
• hook your 'local package' up to your example-app (cd to your example-app clone and runnpm install --save /path/to/the/tgz/file/from/above)
• runng serve --aot

Please make sure your changes pass Angular's AoT compiler, because it's a bit finicky with TS syntax.