Add local flag overrides implementation pattern documentation - #38569
Open
annabfenske wants to merge 2 commits into
Open
Add local flag overrides implementation pattern documentation#38569annabfenske wants to merge 2 commits into
annabfenske wants to merge 2 commits into
Conversation
Document the OpenFeature Multi-Provider pattern for client and server local overrides, and add the page to the Implementation Patterns nav. Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
Author
|
/review |
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
🤖 Automated review by Claude. AI-generated; verify before acting.
Nice, well-structured pattern doc. A few issues to address: the server Node.js snippet references a helper that isn't defined in scope, and the Go/Java tabs only show half the pattern compared to Node.js. Minor style nits noted inline.
Reviewed 836136660eca519faca716af8885d6c4e7abc1d1 — workflow run
Contributor
Preview links (active after the
|
Contributor
|
Opened DOCS-15240 to follow up with editorial review. |
Add missing server helpers, complete Go and Java examples, fix Oxford comma, and link to First Match strategy docs. Co-authored-by: Cursor <cursoragent@cursor.com>
joepeeples
approved these changes
Jul 31, 2026
|
|
||
| <div class="alert alert-warning">Use local overrides only in non-production environments. Restrict or disable this pattern in production builds so end users cannot change flag behavior through local configuration.</div> | ||
|
|
||
| ## How it works |
Contributor
There was a problem hiding this comment.
Suggested change
| ## How it works | |
| ## How local flag overrides work |
|
|
||
| ## How it works | ||
|
|
||
| OpenFeature's Multi-Provider wraps multiple providers behind a single client. By default, it uses the **First Match** strategy: |
Contributor
There was a problem hiding this comment.
Italics are more preferred for new terms, emphasis:
Suggested change
| OpenFeature's Multi-Provider wraps multiple providers behind a single client. By default, it uses the **First Match** strategy: | |
| OpenFeature's Multi-Provider wraps multiple providers behind a single client. By default, it uses the _First Match_ strategy: |
| 2. If the first provider returns `FLAG_NOT_FOUND`, evaluation continues to the next provider. | ||
| 3. Datadog serves as the fallback for any flag not present in the in-memory override set. | ||
|
|
||
| Providers are evaluated in the order you register them. Place the `InMemoryProvider` **first** in the provider list so overrides take precedence over Datadog. |
Contributor
There was a problem hiding this comment.
Suggested change
| Providers are evaluated in the order you register them. Place the `InMemoryProvider` **first** in the provider list so overrides take precedence over Datadog. | |
| Providers are evaluated in the order you register them. Place the `InMemoryProvider` _first_ in the provider list so overrides take precedence over Datadog. |
|
|
||
| ## Client override examples | ||
|
|
||
| <div class="alert alert-info">The Multi-Provider override pattern is supported on <a href="/feature_flags/client/javascript/">JavaScript</a>, <a href="/feature_flags/client/react/">React</a>, <a href="/feature_flags/client/angular/">Angular</a>, <a href="/feature_flags/client/reactnative/">React Native</a>, <a href="/feature_flags/client/ios/">iOS</a>, and <a href="/feature_flags/client/android/">Android</a>. On iOS and Android SDKs, <code>MultiProvider</code> is available, but the OpenFeature SDKs do not ship a built-in in-memory provider — implement a small custom <code>FeatureProvider</code> instead, as shown in the <a href="/feature_flags/client/ios/#testing">iOS</a> and <a href="/feature_flags/client/android/#testing">Android</a> testing documentation.</div> |
Contributor
There was a problem hiding this comment.
Suggested change
| <div class="alert alert-info">The Multi-Provider override pattern is supported on <a href="/feature_flags/client/javascript/">JavaScript</a>, <a href="/feature_flags/client/react/">React</a>, <a href="/feature_flags/client/angular/">Angular</a>, <a href="/feature_flags/client/reactnative/">React Native</a>, <a href="/feature_flags/client/ios/">iOS</a>, and <a href="/feature_flags/client/android/">Android</a>. On iOS and Android SDKs, <code>MultiProvider</code> is available, but the OpenFeature SDKs do not ship a built-in in-memory provider — implement a small custom <code>FeatureProvider</code> instead, as shown in the <a href="/feature_flags/client/ios/#testing">iOS</a> and <a href="/feature_flags/client/android/#testing">Android</a> testing documentation.</div> | |
| <div class="alert alert-info">The Multi-Provider override pattern is supported on <a href="/feature_flags/client/javascript/">JavaScript</a>, <a href="/feature_flags/client/react/">React</a>, <a href="/feature_flags/client/angular/">Angular</a>, <a href="/feature_flags/client/reactnative/">React Native</a>, <a href="/feature_flags/client/ios/">iOS</a>, and <a href="/feature_flags/client/android/">Android</a>. On iOS and Android SDKs, <code>MultiProvider</code> is available, but the OpenFeature SDKs do not ship a built-in in-memory provider. Implement a small custom <code>FeatureProvider</code> instead, as shown in the <a href="/feature_flags/client/ios/#testing">iOS</a> and <a href="/feature_flags/client/android/#testing">Android</a> testing documentation.</div> |
|
|
||
| <div class="alert alert-info">The Multi-Provider override pattern is supported on <a href="/feature_flags/client/javascript/">JavaScript</a>, <a href="/feature_flags/client/react/">React</a>, <a href="/feature_flags/client/angular/">Angular</a>, <a href="/feature_flags/client/reactnative/">React Native</a>, <a href="/feature_flags/client/ios/">iOS</a>, and <a href="/feature_flags/client/android/">Android</a>. On iOS and Android SDKs, <code>MultiProvider</code> is available, but the OpenFeature SDKs do not ship a built-in in-memory provider — implement a small custom <code>FeatureProvider</code> instead, as shown in the <a href="/feature_flags/client/ios/#testing">iOS</a> and <a href="/feature_flags/client/android/#testing">Android</a> testing documentation.</div> | ||
|
|
||
| The examples below use browser JavaScript and show two common ways to populate overrides. Adapt the `loadOverrides` function to match how your team prefers to set overrides, or to the storage mechanism available on your platform (for example, <code>UserDefaults</code> on iOS or <code>SharedPreferences</code> on Android). |
Contributor
There was a problem hiding this comment.
Suggested change
| The examples below use browser JavaScript and show two common ways to populate overrides. Adapt the `loadOverrides` function to match how your team prefers to set overrides, or to the storage mechanism available on your platform (for example, <code>UserDefaults</code> on iOS or <code>SharedPreferences</code> on Android). | |
| The following examples use browser JavaScript and show two common ways to populate overrides. Adapt the `loadOverrides` function to match how your team prefers to set overrides, or to the storage mechanism available on your platform (for example, <code>UserDefaults</code> on iOS or <code>SharedPreferences</code> on Android). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do? What is the motivation?
Adds a new Implementation Patterns page documenting how to use OpenFeature's Multi-Provider pattern with an in-memory provider for local flag overrides during testing and development.
The page includes:
Merge instructions
Merge readiness:
Additional notes
Made with Cursor