ng-component-redux

Angular Redux

Angular component bindings for Redux. Inspired by ng-redux and react-redux. A great way to manage application state in component-based applications.

Advantages

@wbuchwalter did a great job with ng-redux, and if you need to use Redux with an earlier version of Angular, be sure to check out his package. The main motivation for building this package was having the ability to build Angular 1.5 applications with Redux bindings that were component based, just like the React bindings.

Possibly the single greatest advantage of this package is that nearly all code that is written for react-redux can be directly ported to an Angular application using this package. This is because the connect function to create connected components works the same way, and stores are configured and used in the application almost entirely the way you would in a react-redux application. The only exception is that this package provides a helper function that will allow you to get Angular dependencies to use in middleware. This helper can be accessed via import injector from 'ng-component-redux'

Installation

This package requires Angular 1.5.3 or higher. This is because this package relies on Angular 1.5's .component() method, and also takes advantage of the lifecycle hooks introduced in v1.5.3.

To install this package, run:

npm i -S ng-component-redux

The preferred method of using this package is with a build system such as Browserify or Webpack and npm. If, however, you don't yet use a modern build system or npm, you can include the pre-built UMD module which can be found in the dist directory, and access it via the global AngularRedux object. This is not a recommended approach since many complementary redux packages are only available via npm.

Todo

• Examples
• API documentation (In the meantime, take a look at react-redux documentation)

License

MIT

Credits

Huge thank you to @gaearon for creating redux and the official React bindings. This package was heavily based off of and inspired by the React bindings.

Also, many thanks to @wbuchwalter for building ng-redux, which allowed me to gain my first exposure to Redux in an Angular 1.x application.