Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/reference/other-technologies/cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,9 @@ openfeature generate typescript --output ./src/flags

See [here](https://github.com/open-feature/cli/blob/main/docs/commands/openfeature_generate.md) for all available options.

> **_NOTE:_**
> Angular generated code requires `@openfeature/angular-sdk` version `1.1.0` or newer.

### `pull`

Fetch feature flag configurations from a remote source.
Expand Down
14 changes: 7 additions & 7 deletions docs/reference/sdks/client/kotlin.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from kotlin-sdk.
Edits should be made here: https://github.com/open-feature/kotlin-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand All @@ -20,8 +20,8 @@ import MCPInstall from '@site/src/partials/mcp-install';
<img alt="Specification" src="https://img.shields.io/static/v1?label=specification&message=v0.8.0&color=yellow&style=for-the-badge" />
</a>

<a href="https://github.com/open-feature/kotlin-sdk/releases/tag/v0.7.1">
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.7.1&color=blue&style=for-the-badge" />
<a href="https://github.com/open-feature/kotlin-sdk/releases/tag/v0.7.2">
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.7.2&color=blue&style=for-the-badge" />
</a>

<br/>
Expand All @@ -41,10 +41,10 @@ import MCPInstall from '@site/src/partials/mcp-install';
The following [Kotlin Multiplatform Targets](https://www.jetbrains.com/help/kotlin-multiplatform-dev/multiplatform-dsl-reference.html#targets) are supported:

| Supported | Platform | Supported versions |
| --------- | -------------------- | ------------------------------------------------------------------------------ |
| --------- | -------------------- |--------------------------------------------------------------------------------|
| ✅ | Android | SDK 21+ |
| ✅ | JVM | JDK 11+ |
| ✅ | Native | Linux x64 |
| ✅ | Native | Linux x64, iosSimulatorArm64, iosArm64 |
| ❌ | Native | [Other native targets](https://kotlinlang.org/docs/native-target-support.html) |
| ✅ | Javascript (Node.js) | |
| ✅ | Javascript (Browser) | |
Expand All @@ -67,7 +67,7 @@ Installation is preferred via Maven Central.

```kotlin
dependencies {
api("dev.openfeature:kotlin-sdk:0.7.1")
api("dev.openfeature:kotlin-sdk:0.7.2")
}
```

Expand All @@ -77,7 +77,7 @@ dependencies {
kotlin {
sourceSets {
commonMain.dependencies {
api("dev.openfeature:kotlin-sdk:0.7.1")
api("dev.openfeature:kotlin-sdk:0.7.2")
}
}
}
Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/client/swift.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from swift-sdk.
Edits should be made here: https://github.com/open-feature/swift-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/client/web/angular.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
Edits should be made here: https://github.com/open-feature/js-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:47 GMT+0000 (Coordinated Universal Time)
-->

<p align="center" class="github-badges">
Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/client/web/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
Edits should be made here: https://github.com/open-feature/js-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/client/web/react.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
Edits should be made here: https://github.com/open-feature/js-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
42 changes: 36 additions & 6 deletions docs/reference/sdks/server/dart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This content has been automatically generated from dart-server-sdk.
Edits should be made here: https://github.com/open-feature/dart-server-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:47 GMT+0000 (Coordinated Universal Time)
-->

<p align="center" class="github-badges">
Expand All @@ -19,8 +19,8 @@ Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
</a>


<a href="https://github.com/open-feature/dart-server-sdk/releases/tag/v0.0.16">
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.0.16&color=blue&style=for-the-badge" />
<a href="https://github.com/open-feature/dart-server-sdk/releases/tag/v0.0.17">
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.0.17&color=blue&style=for-the-badge" />
</a>

<a href="https://dart.dev/">
Expand Down Expand Up @@ -56,7 +56,7 @@ Dart language version: [3.9.2](https://dart.dev/get-dart/archive)

```yaml
dependencies:
openfeature_dart_server_sdk: ^0.0.16
openfeature_dart_server_sdk: ^0.0.17
```

### Then run:
Expand Down Expand Up @@ -123,6 +123,7 @@ See [here](https://pub.dev/documentation/openfeature_dart_server_sdk/latest/) fo
| ✅ | [Providers](#providers) | Integrate with a commercial, open source, or in-house feature management tool. |
| ✅ | [Targeting](#targeting) | Contextually-aware flag evaluation using [evaluation context](/docs/reference/concepts/evaluation-context). |
| ✅ | [Hooks](#hooks) | Add functionality to various stages of the flag evaluation life-cycle. |
| ✅ | [Tracking](#tracking) | Associate user actions with feature flag evaluations for experimentation. |
| ✅ | [Logging](#logging) | Integrate with popular logging packages. |
| ✅ | [Domains](#domains) | Logically bind clients with providers. |
| ✅ | [Eventing](#eventing) | React to state changes in the provider or flag management system. |
Expand Down Expand Up @@ -214,13 +215,33 @@ For example, a flag enhancing the appearance of a UI component might drive user

Note that some providers may not support tracking; check the documentation for your provider for more information.

```dart
import 'package:openfeature_dart_server_sdk/open_feature_api.dart';
import 'package:openfeature_dart_server_sdk/feature_provider.dart';

final api = OpenFeatureAPI();
final client = api.getClient('my-app');

// Track a user action associated with a feature flag evaluation
await client.track(
'checkout-completed',
context: EvaluationContext(attributes: {
'user': 'user-123',
}),
trackingDetails: TrackingEventDetails(
value: 99.99,
attributes: {'currency': 'USD'},
),
);
```

### Logging

Note that in accordance with the OpenFeature specification, the SDK doesn't generally log messages during flag evaluation.

#### Logging Hook

The Dart SDK includes a `LoggingHook`, which logs detailed information at key points during flag evaluation, using [TBD](https://github.com/open-feature/dart-server-sdk/blob/main/TBD) structured logging API.
The Dart SDK includes a `LoggingHook`, which logs detailed information at key points during flag evaluation, using the [package:logging](https://pub.dev/packages/logging) structured logging API.
This hook can be particularly helpful for troubleshooting and debugging; simply attach it at the global, client or invocation level and ensure your log level is set to "debug".

##### Usage example
Expand Down Expand Up @@ -387,7 +408,7 @@ transactionManager.popContext();

To develop a provider, you need to create a new project and include the OpenFeature SDK as a dependency.
This can be a new repository or included in [the existing contrib repository](https://github.com/open-feature/dart-server-sdk-contrib) available under the OpenFeature organization.
Youll then need to write the provider by implementing the `FeatureProvider` interface exported by the OpenFeature SDK.
You'll then need to write the provider by implementing the `FeatureProvider` interface exported by the OpenFeature SDK.

```dart
import 'dart:async';
Expand Down Expand Up @@ -418,6 +439,15 @@ class MyCustomProvider implements FeatureProvider {
// Clean up resources
}

@override
Future<void> track(
String trackingEventName, {
Map<String, dynamic>? evaluationContext,
TrackingEventDetails? trackingDetails,
}) async {
// Send tracking event to your backend, or no-op if unsupported
}

@override
Future<FlagEvaluationResult<bool>> getBooleanFlag(
String flagKey,
Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/server/dotnet.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from dotnet-sdk.
Edits should be made here: https://github.com/open-feature/dotnet-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
4 changes: 2 additions & 2 deletions docs/reference/sdks/server/go.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This content has been automatically generated from go-sdk.
Edits should be made here: https://github.com/open-feature/go-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down Expand Up @@ -45,7 +45,7 @@ import MCPInstall from '@site/src/partials/mcp-install';

### Requirements

Go language version: [1.24](https://go.dev/doc/devel/release#go1.24.0)
Go language version: [1.25](https://go.dev/doc/devel/release#go1.25.0)

> [!NOTE]
> The OpenFeature Go SDK only supports currently maintained Go language versions.
Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/server/java.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This content has been automatically generated from java-sdk.
Edits should be made here: https://github.com/open-feature/java-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:45 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/server/javascript/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
Edits should be made here: https://github.com/open-feature/js-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/server/javascript/nestjs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
Edits should be made here: https://github.com/open-feature/js-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/server/php.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This content has been automatically generated from php-sdk.
Edits should be made here: https://github.com/open-feature/php-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
13 changes: 12 additions & 1 deletion docs/reference/sdks/server/python.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This content has been automatically generated from python-sdk.
Edits should be made here: https://github.com/open-feature/python-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down Expand Up @@ -187,6 +187,17 @@ client.get_boolean_flag("my-flag", False, flag_evaluation_options=options)

The OpenFeature SDK logs to the `openfeature` logger using the `logging` package from the Python Standard Library.

#### Logging Hook

The Python SDK includes a `LoggingHook`, which logs detailed information at key points during flag evaluation, using the `logging` package. This hook can be particularly helpful for troubleshooting and debugging; simply attach it at the global, client or invocation level and ensure your log level is set to "debug".

```python
from openfeature import api
from openfeature.hook.logging_hook import LoggingHook

api.add_hooks([LoggingHook()])
```

### Domains

Clients can be assigned to a domain.
Expand Down
2 changes: 1 addition & 1 deletion docs/reference/sdks/server/ruby.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This content has been automatically generated from ruby-sdk.
Edits should be made here: https://github.com/open-feature/ruby-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Sun Mar 08 2026 22:19:16 GMT-0700 (Pacific Daylight Time)
Last updated at Thu Mar 19 2026 08:21:46 GMT+0000 (Coordinated Universal Time)
-->
import MCPInstall from '@site/src/partials/mcp-install';

Expand Down
8 changes: 4 additions & 4 deletions docs/reference/sdks/server/rust.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,16 +9,16 @@ This content has been automatically generated from rust-sdk.
Edits should be made here: https://github.com/open-feature/rust-sdk
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs

Last updated at Wed Feb 18 2026 08:21:17 GMT+0000 (Coordinated Universal Time)
Last updated at Thu Mar 19 2026 08:21:47 GMT+0000 (Coordinated Universal Time)
-->

<p align="center" class="github-badges">
<a href="https://github.com/open-feature/spec/releases/tag/v0.5.2">
<img alt="Specification" src="https://img.shields.io/static/v1?label=specification&message=v0.5.2&color=yellow&style=for-the-badge" />
</a>

<a href="https://github.com/open-feature/rust-sdk/releases/tag/open-feature-v0.2.7">
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.2.7&color=blue&style=for-the-badge" />
<a href="https://github.com/open-feature/rust-sdk/releases/tag/open-feature-v0.3.0">
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.3.0&color=blue&style=for-the-badge" />
</a>


Expand Down Expand Up @@ -50,7 +50,7 @@ This package was built with Rust version `1.77.0`. Earlier versions might work,
Add the following content to the `Cargo.toml` file:

```toml
open-feature = "0.2.7"
open-feature = "0.3.0"
```

### Usage
Expand Down
12 changes: 6 additions & 6 deletions src/datasets/sdks/sdk-compatibility.json
Original file line number Diff line number Diff line change
Expand Up @@ -420,8 +420,8 @@
"path": "/docs/reference/sdks/client/kotlin",
"category": "Client",
"release": {
"href": "https://github.com/open-feature/kotlin-sdk/releases/tag/v0.7.1",
"version": "0.7.1",
"href": "https://github.com/open-feature/kotlin-sdk/releases/tag/v0.7.2",
"version": "0.7.2",
"stable": false
},
"spec": {
Expand Down Expand Up @@ -592,8 +592,8 @@
"path": "/docs/reference/sdks/server/dart",
"category": "Server",
"release": {
"href": "https://github.com/open-feature/dart-server-sdk/releases/tag/v0.0.16",
"version": "0.0.16",
"href": "https://github.com/open-feature/dart-server-sdk/releases/tag/v0.0.17",
"version": "0.0.17",
"stable": false
},
"spec": {
Expand Down Expand Up @@ -626,8 +626,8 @@
"path": "/docs/reference/sdks/server/dart#eventing"
},
"Tracking": {
"status": "",
"path": "/docs/reference/sdks/server/dart"
"status": "",
"path": "/docs/reference/sdks/server/dart#tracking"
},
"Transaction Context Propagation": {
"status": "✅",
Expand Down
Loading