Skip to content

Repository files navigation

feature-flag FeatureOne v5.2.0

GitHub ReleaseLicense: MITbuild-masterCodeQL.Net.Net.Net

.Net Library to implement feature toggles.

Nuget Packages

PackageLatestDetails
FeatureOneNuGet versionProvides core functionality to implement feature toggles with no backend storage provider. Needs package consumer to provide IStorageProvider implementation. Ideal for use case that requires custom storage backend. v5.2.0: RelationalCondition, net10.0 support, package upgrades, expanded test coverage.
FeatureOne.SQLNuGet versionProvides SQL storage provider for implementing feature toggles using SQL backend. v5.2.0: net10.0 support, package upgrades.
FeatureOne.FileNuGet versionProvides File storage provider for implementing feature toggles using File System backend. v5.2.0: net10.0 support, package upgrades.

Concept

What is a feature toggle?

Feature toggle is a mechanism that allows code to be turned “on” or “off” remotely without the need for a deploy. Feature toggles are commonly used in applications to gradually roll out new features, allowing teams to test changes on a small subset of users before releasing them to everyone.

How feature toggles work

Feature toggle is typically a logical check added to codebase to execute or ignore certain functionality in context based on evaluated status of the toggle at runitme.

In code, the functionality to be released is wrapped so that it can be controlled by the status of a feature toggle. If the status of the feature toggle is “on”, then the wrapped functionality is executed. If the status of the feature toggle is “off”, then the wrapped functionality is skipped. The statuses of each feature is provided by a store provider external to the application.

The benefits of feature toggles

The primary benefit of feature flagging is that it mitigates the risks associated with releasing changes to an application. Whether it be a new feature release or a small refactor, there is always the inherent risk of releasing new regressions. To mitigate this, changes to an application can be placed behind feature toggles, allowing them to be turned “on” or “off” in the event of an emergency.

Getting Started?

i. Installation

Install the latest nuget package as appropriate.

FeatureOne - for installing FeatureOne for custom IStorageProvider implementation.

NuGet\Install-Package FeatureOne

FeatureOne.SQL - for installing FeatureOne with SQL storage provider.

NuGet\Install-Package FeatureOne.SQL

FeatureOne.File - for installing FeatureOne with File system storage provider.

NuGet\Install-Package FeatureOne.File

ii. Developer Guide

Please see Developer Guide for details on how to implement FeatureOne in your project.

Support

If you are having problems, please let me know by raising a new issue.

License

This project is licensed with the MIT license.

Version History

The following previous versions are available:

VersionRelease Notes
v5.2.0Notes
v5.1.0Notes
v5.0.0Notes
v4.0.0Notes
v3.0.0Notes
v2.0.0Notes

Recent Releases

VersionRelease DateTypeKey ChangesBackward Compatibility
v5.0.0PreviousInitialCore feature toggle functionalityN/A (Initial release)
v5.1.0Nov 03, 2025MinorSecurity fixes (ReDoS protection, secure type loading), architectural improvements (prefix matching, dependency injection), new features (DateRangeCondition, configuration validation), DI integrationHigh - maintains all existing functionality with minor security-related behavioral changes
v5.2.0Mar 18, 2026MinorNew condition (RelationalCondition with 5 relational operators), target framework (added net10.0, removed netstandard2.0 and net8.0), package upgrades (all MS packages to 10.0.5), expanded test coverage (98%+ line coverage)High - fully backward compatible, additive changes only

Credits

Thank you for reading. Please fork, explore, contribute and report. Happy Coding !! :)

Releases

Packages

Used by

Contributors

Languages