Breaking API Changes:

  • Remove StandardAction and StandardActionConvertible (#270) - @mjarvis

    • The existence of StandardAction and StandardActionConvertible is somewhat confusing to new users, and does not have a direct use case within the core ReSwift library. Therefore, it has been moved to ReSwift-Recorder where it belongs.
    • If you’re using StandardAction in your project without ReSwift-Recorder, you can copy the old implementation into your project as a middle ground while you migrate away from its usage.
  • Make Store’s state setter private (#354) - @mokagio

    • Removes the ability to directly set state by making it private(set). This prevents users from bypassing reducers and middleware. All mutation of the state must occur through the normal Action & Reducer methods.
    • This deprecates the usage of ReSwift-Recorder. Changes may be made to that library in the future in order to support this change.


  • Add Subscription skip(when:) and only(when:) (#242) - @mjarvis
  • Add automaticallySkipsRepeats configuration option to Store initializer (#262) - @DivineDominion
  • Improve subscription & state update performance (#325) - @mjarvis
  • Enable build settings Allow app extension API only (#328) - @oradyvan


Released: 12/19/2017



Released: 4/19/2017

Breaking API Changes:

  • Introduced a new Subscription API (#203) - @Ben-G, @mjarvis, @DivineDominion

    • The subscription API provides basic operators, such as skipRepeats (skip calls to newState unless state value changed) and select (sub-select a state).
    • This is a breaking API change that requires migrating existing subscriptions that sub-select a portion of a store’s state:
    • Subselecting state in 3.0.0:
      store.subscribe(subscriber) { ($0.testValue, $0.otherState?.name) }
    • Subselecting state in 4.0.0:
      store.subscribe(subscriber) {
        $ {
          ($0.testValue, $0.otherState?.name)
    • For any store state that is Equatable or any sub-selected state that is Equatable, skipRepeats will be used by default.
    • For states/substates that are not Equatable, skipRepeats can be implemented via a closure:
    store.subscribe(subscriber) {
      $ {
          }.skipRepeats {
              return $0 == $1
  • Reducer type has been removed in favor of reducer function (#177) - Ben-G

    • Here’s an example of a new app reducer, for details see the README:
    func counterReducer(action: Action, state: AppState?) -> AppState {
        var state = state ?? AppState()
        switch action {
        case _ as CounterActionIncrease:
            state.counter += 1
        case _ as CounterActionDecrease:
            state.counter -= 1
        return state
  • dispatch functions now return Void instead of Any (#187) - @Qata

    • The return type has been removed without any replacement, since the core team did not find any use cases of it. A common usage of the return type in redux is returning a promise that is fullfilled when a dispatched action is processed. While it’s generally discouraged to disrupt the unidirectional data flow using this mechanism we do provide a dispatch overload that takes a callback argument and serves this purpose.
  • Make dispatch argument in middleware non-optional (#225) - @dimazen, @mjarvis, @Ben-G

  • Middleware now has a generic type parameter that is used for the getState method and matches the Store’s State type. This allows accessing the state in middleware code without type casting (#226) - @mjarvis


  • Extend StoreType with substate selector subscription (#192) - @mjarvis
  • Add DispatchingStoreType protocol for testing (#197) - @mjarvis
  • Installation guide for Swift Package Manager - @thomaspaulmann
  • Update documentation to reflect breaking API changes - @mjarvis
  • Clarify error message on concurrent usage of ReSwift - @langford


Released: 11/12/2016

Breaking API Changes:

  • Dropped support for Swift 2.2 and lower (#157) - @Ben-G

API Changes:

  • Mark Store as open, this reverts a previously accidental breaking API Change (#157) - @Ben-G


  • Update to Swift 3.0.1 - @Cristiam, @Ben-G
  • Documentation changes - @vkotovv


Released: 09/15/2016


  • Swift 3 preview compatibility, maintaining Swift 2 naming - (#126) - @agentk
  • Xcode 8 GM Swift 3 Updates (#149) - @tkersey
  • Migrate Quick/Nimble testing to XCTest - (#127) - @agentk
  • Automatically build docs via Travis CI (#128) - @agentk
  • Documentation Updates & Fixes- @mikekavouras, @ColinEberhardt


Released: 06/27/2016

Breaking API Changes:

  • Significant Improvements to Serialization Code for StandardAction (relevant for recording tools) - @okla


  • Swift 2.3 Updates - @agentk
  • Documentation Updates & Fixes - @okla, @gregpardo, @tomj, @askielboe, @mitsuse, @esttorhe, @RyanCCollins, @thomaspaulmann, @jlampa


Released: 03/19/2016

API Changes:

  • Remove callback arguments on synchronous dispatch methods - @Ben-G


  • Move all documentation source into Docs, except Readme, Changelog and License - @agentk
  • Replace duplicated documentation with an enhanced build script - @agentk
  • Set CocoaPods documentation URL - (#56) @agentk
  • Update documentation for 1.0 release - @Ben-G


Released: 02/20/2016

API Changes:

  • Subscribers can now sub-select a state when they subscribe to the store (#61) - @Ben-G
  • Rename initially dispatched Action to ReSwiftInit - @vfn


  • Fix retain cycle caused by middleware (issue: #66) - @Ben-G
  • Store now holds weak references to subscribers to avoid unexpected memory managegement behavior (issue: #62) - @vfn
  • Documentation Fixes - @victorpimentel, @vfn, @juggernate, @raheelahmad



Released: 01/23/2016

API Changes:

  • Pass typed store reference into ActionCreator. ActionCreator can now access Stores state without the need for typecasts - @Ben-G
  • Store can now be initialized with an empty state, allowing reducers to hydrate the store - @Ben-G


  • Break retain cycle when using middelware - @sendyhalim


  • Update Documentation to reflect renaming to ReSwift - @agentk
  • Documentation fixes - @orta and @sendyhalim
  • Refactoring - @dcvz and @sendyhalim