This provider enables using IntelliToggle’s feature management platform with the OpenFeature Dart Server-Side SDK.
Note: This provider targets multi-user server environments (e.g. web servers, back-end services). It is not intended for use in Flutter desktop or embedded contexts.
IntelliToggle is a SaaS feature-flag and experimentation platform that powers dynamic rollouts, canary deployments, and real-time flag evaluations. By integrating with OpenFeature, you can swap providers transparently, leverage IntelliToggle’s advanced rules engine, and maintain consistent flag behavior across services.
Compatible with Dart 3.8.1 and above.
Add to your server-side pubspec.yaml:
dependencies:
openfeature_dart_server_sdk: ^0.0.10
openfeature_provider_intellitoggle: ^0.0.3Then run:
dart pub getimport 'package:openfeature_dart_server_sdk/openfeature_dart_server_sdk.dart';
import 'package:openfeature_provider_intellitoggle/openfeature_provider_intellitoggle.dart';
void main() async {
// Create and register the IntelliToggle provider
final provider = IntelliToggleProvider(
sdkKey: 'YOUR_INTELLITOGGLE_SDK_KEY',
options: IntelliToggleOptions(
timeout: Duration(seconds: 5),
baseUri: Uri.parse('https://api.intellitoggle.com'),
),
);
// Set as the global OpenFeature provider
await OpenFeatureAPI().setProvider(provider);
// Create a client and evaluate a flag
final client = IntelliToggleClient(namespace: 'my-service');
final value = await client.getBooleanValue(
'new-dashboard-enabled',
false,
evaluationContext: {
'kind': 'user',
'targetingKey': 'user-123',
'role': 'beta_tester',
},
);
print('Feature “new-dashboard-enabled” = $value');
}IntelliToggle supports both single-context and multi-context flag evaluations. The provider inspects your evaluationContext for a kind attribute:
- No
kind→ treated as a single “user” context. kind: 'multi'→ multi-context; additional keys denote each context.kind: '<anything-else>'→ single context of that custom kind.
The
targetingKey(orkey) attribute is required and takes precedence overkeyif both are present.
privateAttributes(List) → hides sensitive fieldsanonymous(bool) → flags the context as anonymousname(String) → human-readable name
final ctx = {
'targetingKey': 'user-123',
'name': 'Jane Doe',
'anonymous': false,
};
final flag = await client.getBooleanValue('beta-feature', false, evaluationContext: ctx);final ctx = {
'kind': 'organization',
'targetingKey': 'org-456',
'plan': 'enterprise',
};
final flag = await client.getStringValue('org-level-flag', 'none', evaluationContext: ctx);final ctx = {
'kind': 'multi',
'user': {
'targetingKey': 'user-123',
'email': '[email protected]',
},
'project': {
'targetingKey': 'proj-789',
'tier': 'beta',
},
};
final flag = await client.getObjectValue<Map<String, dynamic>>(
'project-experiment',
{},
evaluationContext: ctx,
);You can listen to lifecycle events:
provider.events.listen((event) {
if (event.type == IntelliToggleEventType.ready) {
print('IntelliToggle provider is ready!');
}
if (event.type == IntelliToggleEventType.configurationChanged) {
print('Flags changed!');
}
});Before your process shuts down, flush any pending events:
await provider.shutdown();This SDK includes utilities for rapid local development and test suites:
The InMemoryProvider lets you define and update feature flags in-memory at runtime. This is ideal for unit tests or local development, where you want to avoid network calls or external dependencies.
Usage Example:
import 'package:openfeature_provider_intellitoggle/openfeature_provider_intellitoggle.dart';
void main() async {
// Create and register the in-memory provider
final provider = InMemoryProvider();
provider.setFlag('my-flag', true);
await OpenFeatureAPI().setProvider(provider);
// Evaluate a flag
final client = IntelliToggleClient(namespace: 'test');
final value = await client.getBooleanValue('my-flag', false);
print('my-flag = $value'); // prints: my-flag = true
// Listen for configuration changes
provider.events.listen((event) {
if (event.type == IntelliToggleEventType.configurationChanged) {
print('Flags updated!');
}
});
// Update a flag at runtime
provider.setFlag('my-flag', false); // Triggers configurationChanged event
}This provider exposes an OREP HTTP API for remote flag evaluation.
dart run bin/orep_server.dartThe server will listen on http://localhost:8080.
curl -X POST http://localhost:8080/v1/flags/bool-flag/evaluate \
-H "Content-Type: application/json" \
-d '{"defaultValue": false, "type": "boolean", "context": {}}'Response:
{
"flagKey": "bool-flag",
"type": "boolean",
"value": true,
"reason": "STATIC",
"evaluatedAt": "2025-06-02T12:34:56.789Z",
"evaluatorId": "InMemoryProvider"
}Security Note: The OREP/OPTSP server requires a Bearer token for authentication. Do not expose it to untrusted networks.
If a request is invalid, the server returns:
{
"error": "Invalid JSON",
"details": "FormatException: Unexpected character..."
}You can configure the OREP server with environment variables:
OREP_HOST(default: 0.0.0.0)OREP_PORT(default: 8080)OREP_AUTH_TOKEN(default: changeme-token)
This provider supports the OPTSP endpoints for automated conformance testing.
curl -X POST http://localhost:8080/v1/provider/seed \
-H "Content-Type: application/json" \
-d '{"flags": {"my-flag": true, "other-flag": "hello"}}'curl -X POST http://localhost:8080/v1/provider/resetcurl http://localhost:8080/v1/provider/metadataAll OREP/OPTSP endpoints require a Bearer token for authentication.
Set the token via the OREP_AUTH_TOKEN environment variable (default: changeme-token).
Example request:
curl -H "Authorization: Bearer changeme-token" ...We welcome contributions! See CONTRIBUTING.md for guidelines.
- Website: https://intellitoggle.com
- Docs & CLI: https://sdks.aortem.io/intellitoggle
- API Reference: https://api.intellitoggle.com/docs
- GitHub: https://github.com/aortem/intellitoggle-openfeature-provider-dart-server