Repository files navigation

Streams of values over time. Tailored for Swift.

🚄Release Roadmap

Learn about theCore Reactive Primitives in ReactiveSwift, andBasic Operators available offered by these primitives.

Module	Repository	Description
ReactiveCocoa	ReactiveCocoa/ReactiveCocoa	Extend Cocoa frameworks and Objective-C runtime APIs with ReactiveSwift bindings and extensions.
Loop	ReactiveCocoa/Loop	Composable unidirectional data flow with ReactiveSwift.
ReactiveSwift Composable Architecture	trading-point/reactiveswift-composable-architecture	ThePointfree Composable Architecture using ReactiveSwift instead of Combine.

ReactiveSwift offers composable, declarative and flexible primitives that are built around the grand concept ofstreams of values over time.

These primitives can be used to uniformly represent common Cocoa and generic programming patterns that are fundamentally an act of observation, e.g. delegate pattern, callback closures, notifications, control actions, responder chain events,futures/promises andkey-value observing (KVO).

Because all of these different mechanisms can be represented in thesame way,it’s easy to declaratively compose them together, with less spaghetticode and state to bridge the gap.

1. API Reference

2. API Contracts

   Contracts of the ReactiveSwift primitives, Best Practices with ReactiveSwift, and Guidelines on implementing custom operators.

3. Debugging Techniques

4. RxSwift Migration Cheatsheet

ReactiveSwift supports macOS 10.13+, iOS 11.0+, watchOS 4.0+, tvOS 11.0+ and Linux.

If you useCarthage to manage your dependencies, simply addReactiveSwift to yourCartfile:

github "ReactiveCocoa/ReactiveSwift" ~> 6.1

If you use Carthage to build your dependencies, make sure you have addedReactiveSwift.framework to the "Linked Frameworks and Libraries" section of your target, and have included them in your Carthage framework copying build phase.

If you useCocoaPods to manage your dependencies, simply addReactiveSwift to yourPodfile:

pod 'ReactiveSwift', '~> 6.1'

If you use Swift Package Manager, simply add ReactiveSwift as a dependencyof your package inPackage.swift:

.package(url: "https://github.com/ReactiveCocoa/ReactiveSwift.git", from: "6.1.0")

1. Add the ReactiveSwift repository as asubmodule of yourapplication’s repository.
2. Rungit submodule update --init --recursive from within the ReactiveCocoa folder.
3. Drag and dropReactiveSwift.xcodeproj into your application’s Xcodeproject or workspace.
4. On the “General” tab of your application target’s settings, addReactiveSwift.framework to the “Embedded Binaries” section.
5. If your application target does not contain Swift code at all, you should alsoset theEMBEDDED_CONTENT_CONTAINS_SWIFT build setting to “Yes”.

We also provide a Playground, so you can get used to ReactiveCocoa's operators. In order to start using it:

1. Clone the ReactiveSwift repository.
2. Retrieve the project dependencies using one of the following terminal commands from the ReactiveSwift project root directory:
   • git submodule update --init --recursiveOR, if you haveCarthage installed
   • carthage checkout
3. OpenReactiveSwift.xcworkspace
4. BuildReactiveSwift-macOS scheme
5. Finally open theReactiveSwift.playground
6. ChooseView > Show Debug Area

If you need any help, please visit ourGitHub issues orStack Overflow. Feel free to file an issue if you do not manage to find any solution from the archives.

Current Stable Release:

ReactiveSwift has no plan to declare ABI and module stability at the moment. It will continue to be offered as a source only dependency for the foreseeable future.