RealFlags makes it easy to configure feature flagsin your codebase. It's designed for Swift and provides a simple and elegant abstraction layer over multiple providers you can query with your priority. It also has a handy UI tool to browse and alter values directly at runtime!
Features | What You Get | Flags Browser & Editor | Tests | Documentation | Requirements | Installation | Powered Apps | Support & Contribute | License
- 💡 Simple & Elegant: Effectively describe and organize your own flags with a type-safe structure. It will abstract your implementation and consistently reduce the amount of code to manage your feature flags
- 💡 Extensible: You can use one of the default data providers or create your own. We support Firebase Remote and Local configurations too
- 💡 Complete: Feature Flags support all primitive datatypes and complex objects:
Int(and any numeric variant),String,Bool,Data,Date,URL,Dictionary,Array(values must conform toFlagProtocol), Optional Values and virtually any object conform toCodableprotocol! - 💡 Configurable: Enable, disable and customize features at runtime
- 💡 Integrated UI Tool: the handy UI Tool allows you to customize and read flags at a glance
Would you use RealFlags in your product? We wrote an article about it. Check it out here
Our goal in making RealFlags is to provide a type-safe abstract way to describe and query for feature flags.
The first step is to describe your collection of flags:
// Define the structure of your feature flags with type-safe properties!
struct UserFlags: FlagCollectionProtocol {
@Flag(default: true, description: "Show social login options along native login form")
var showSocialLogin: Bool
@Flag(default: 0, description: "Maximum login attempts before blocking account")
var maxLoginAttempts: Int
@Flag(key: "rating_mode", default: "at_launch", description: "The behaviour to show the rating popup")
var appReviewRating: String
public init() {}
}This represents a type-safe description of some flags grouped in a collection.
Each feature flags property is identified by the @Flag annotation.
It's time load values for this collection; using a new FlagsLoader you will be able to load and query collection's values from one or more data providers:
// Allocate your own data providers
let localProvider = LocalProvider(localURL: fileURL)
let fbProvider = FirebaseRemoteProvider()
// Loader is the point for query values
let userFlagsLoader = FlagsLoader(UserFlags.self, // load flags definition
description: .init(name: "User Features", description: "Cool experimental features for user account"),
providers: [fbProvider, localProvider]) // set providersNow you can query values from userFlagsLoader by using the UserFlags structure (it supports autocomplete and type-safe values thanks to @dynamicMemberLookup!).
Let me show it:
if userFlagsLoader.showSocialLogin { // query properties as type-safe with autocomplete!
// do some stuff
}Values are obtained respecting the order you have specified, in this case from Firebase Remote Config service, then, when no value is found, into the local repository.
If no values are available, the default value specified in @Flags annotation is returned.
This is just an overview of the library; if you want to know more, follow the documentation below.
RealFlags also comes with a handy tool you can use to browse and edit feature flag values directly in your client! It can be helpful for testing purposes or allow product owners to enable/disable and verify features of the app.
Checkout the doc for more infos!
flags_browser_video.mp4
RealFlags is fully documented at the source-code level. You'll get autocomplete with doc inside XCode for free; moreover, you can read the full Apple's DoCC Documentation automatically generated thanks to Swift Package Index Project from here:
The following documentation describes detailed usage of the library.
- 1.0 - Introduction
- 1.1 - @Flag Annotation
- 1.2 - @Flag Supported Datatypes
- 1.3 -
Codabletypes and@Flag - 1.4 - Computed @Flag
- 1.5 - Load a Feature Flag Collection in a
FlagLoader - 1.6 - Configure Key Evaluation for
FlagsLoader's@Flag - 1.7 - Query a specific data provider
- 1.8 - Set Flag defaultValue at runtime
- 1.9 - Reset Flag values
- 1.10 - Reset LocalProvider values
- 2.0 - Organize Feature Flags
- 3.0 - Advanced Usage
RealFlags includes an extensive collection of unit tests: you can find it in the Tests directory.
RealFlags can be installed on any platform which supports Swift 5.4+, including Windows and Linux. On Apple platform, the following configuration is required:
- iOS 12+
- Xcode 12.5+
- Swift 5.4+
To use RealFlags in your project you can use Swift Package Manager (our primary choice) or CocoaPods.
Add it as a dependency in a Swift Package, and add it to your Package.swift:
dependencies: [
.package(url: "https://github.com/immobiliare/RealFlags.git", from: "1.0.0")
]And add it as a dependency of your target:
targets: [
.target(name: "MyTarget", dependencies: [
.product(name: "https://github.com/immobiliare/RealFlags.git", package: "RealFlags")
])
]In Xcode 11+, you can also navigate to the File menu and choose Swift Packages -> Add Package Dependency..., then enter the repository URL and version details.
RealFlags can be installed with CocoaPods by adding pod 'RealFlags' to your Podfile.
pod 'RealFlags' // to import the core framework
pod 'RealFlagsFirebase' // to also import Firebase Data ProviderThe amazing mobile team at ImmobiliareLabs created RealFlags, the Tech dept at Immobiliare.it, the first real estate site in Italy. We are currently using RealFlags in all of our products.
If you are using RealFlags in your app drop us a message.
We'd love for you to contribute to RealFlags! If you have questions about using RealFlags, bugs, and enhancement, please feel free to reach out by opening a GitHub Issue.
RealFlags is licensed under the MIT license. See the LICENSE file for more information.