{"id":29946100,"url":"https://github.com/wingify/vwo-fme-flutter-sdk","last_synced_at":"2026-01-20T16:29:32.902Z","repository":{"id":269420795,"uuid":"906199905","full_name":"wingify/vwo-fme-flutter-sdk","owner":"wingify","description":"VWO Feature Management and Experimentation SDK for Flutter","archived":false,"fork":false,"pushed_at":"2025-12-19T12:12:19.000Z","size":152,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-12-22T04:43:47.819Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://developers.vwo.com/v2/docs/fme-flutter","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wingify.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-20T11:24:58.000Z","updated_at":"2025-12-19T12:12:23.000Z","dependencies_parsed_at":"2025-12-19T21:03:42.551Z","dependency_job_id":null,"html_url":"https://github.com/wingify/vwo-fme-flutter-sdk","commit_stats":null,"previous_names":["wingify/vwo-fme-flutter-sdk"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/wingify/vwo-fme-flutter-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fvwo-fme-flutter-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fvwo-fme-flutter-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fvwo-fme-flutter-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fvwo-fme-flutter-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wingify","download_url":"https://codeload.github.com/wingify/vwo-fme-flutter-sdk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wingify%2Fvwo-fme-flutter-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607151,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-03T05:12:49.215Z","updated_at":"2026-01-20T16:29:32.896Z","avatar_url":"https://github.com/wingify.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VWO FME Flutter SDK\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)\n\n## Overview\n\nThe **VWO Feature Management and Experimentation SDK** (VWO FME Flutter SDK) enables Flutter developers to integrate feature flagging and experimentation into their applications. This SDK provides full control over feature rollout, A/B testing, and event tracking, allowing teams to manage features dynamically and gain insights into user behavior.\n\n## Requirements\n\nThe Flutter SDK supports:\n- iOS 12.0 or higher\n- Android API level 21 or higher\n\n## SDK Installation\n\nAdd the VWO FME Flutter SDK to your project's `pubspec.yaml` file:\n\n```yaml\ndependencies:\n  vwo_fme_flutter_sdk: ^\u003clatestVersion\u003e\n```\n\nThe latest version of the SDK can be found in [pub.dev](https://pub.dev/packages/vwo_fme_flutter_sdk)\n\nFor iOS, install the CocoaPods dependencies by running the command below. Supports iOS version 12.0 and above.\n\n```bash\nflutter pub get\n```\n\n## Basic Usage\n\nThe following example demonstrates initializing the SDK with a VWO account ID and SDK key, setting a user context, checking if a feature flag is enabled, and tracking a custom event.\n\n```dart\nimport 'package:vwo_fme_flutter_sdk/vwo.dart';\nimport 'package:vwo_fme_flutter_sdk/vwo/models/vwo_init_options.dart';\nimport 'package:vwo_fme_flutter_sdk/vwo/models/vwo_user_context.dart';\nimport 'package:vwo_fme_flutter_sdk/vwo/models/get_flag.dart';\nimport 'package:vwo_fme_flutter_sdk/logger/log_transport.dart';\n\n// Create a custom logger implementation\nclass DartLogger implements LogTransport {\n  @override\n  void log(String level, String? message) {\n    if (message == null) return;\n    print(\"FME-Flutter: [$level] $message\");\n  }\n}\n\n// Initialize VWO SDK with logger configuration\nvar transport = \u003cString, dynamic\u003e{};\ntransport[\"defaultTransport\"] = DartLogger();\n\nvar logger = \u003cMap\u003cString, dynamic\u003e\u003e[];\nlogger.add(transport);\n\nfinal vwoInitOptions = VWOInitOptions(\n  sdkKey: SDK_KEY,\n  accountId: ACCOUNT_ID,\n  logger: {\"level\": \"TRACE\", \"transports\": logger},\n);\n\n// Create VWO instance with the vwoInitOptions\nfinal vwoClient = await VWO.init(vwoInitOptions);\n\n// Create VWOUserContext object\nfinal context = VWOUserContext(\n    id: \"unique_user_id\",\n    customVariables: {\"key1\": 21, \"key2\":\"value\"}\n);\n\n// Get the GetFlag object for the feature key and context\nfinal featureFlag = await vwoClient?.getFlag(\n  featureKey: \"feature_key\",\n  context: context,\n);\n\nif (featureFlag != null) {\n  // Get the flag value\n  final isFeatureFlagEnabled = featureFlag.isEnabled();\n\n  // Get the variable value for the given variable key and default value\n  dynamic variable = featureFlag.getVariable(\"feature_flag_variable\", \"default-value\");\n}\n\n// Track the event for the given event name and context\nfinal properties = {\"cartvalue\": 10};\nawait vwoClient?.trackEvent(\n  eventName: \"event-name\",\n  context: context,\n  eventProperties: properties,\n);\n\n// Send attributes data\nfinal attributes = {\n  \"attributeName\": \"attributeValue\"\n};\nawait vwoClient?.setAttribute(\n  attributes: attributes,\n  context: context,\n);\n```\n\n## Advanced Configuration Options\n\nTo customize the SDK further, additional parameters can be passed to the `init()` API. Here's a table describing each option:\n\n| **Parameter**              | **Description**                                                                                                                                             | **Required** | **Type** | **Example**                     |\n|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| ------------ |----------|---------------------------------|\n| `accountId`                | VWO Account ID for authentication.                                                                                                                          | Yes          | Integer  | `123456`                        |\n| `sdkKey`                   | SDK key corresponding to the specific environment to initialize the VWO SDK Client. You can get this key from VWO Application.                              | Yes          | String   | `'32-alpha-numeric-sdk-key'`    |\n| `pollInterval`             | Time interval for fetching updates from VWO servers (in milliseconds).                                                                                      | No           | Integer  | `60000`                         |\n| `cachedSettingsExpiryTime` | Controls the duration (in milliseconds) the SDK uses cached settings before fetching new ones.                                                              | No           | Integer  | `60000`                         |\n| `batchMinSize`             | Uploads are triggered when the batch reaches this minimum size.                                                                                             | No           | Integer  | `10`                            |\n| `batchUploadTimeInterval`  | Specifies the time interval (in milliseconds) for periodic batch uploads.                                                                                   | No           | Integer  | `60000`                         |\n| `logger`                   | Custom logger configuration for controlling log levels and implementing custom logging behavior.                                                             | No           | Object   | See [Logger](#logger) section   |\n\n### User Context\n\nThe `context` object uniquely identifies users and is crucial for consistent feature rollouts. A typical `context` includes an `id` for identifying the user. It can also include other attributes that can be used for targeting and segmentation, such as `customVariables`.\n\n#### Parameters Table\n\nThe following table explains all the parameters in the `context` object:\n\n| **Parameter**     | **Description**                                                            | **Required** | **Type** | **Example**                       |\n| ----------------- | -------------------------------------------------------------------------- | ------------ | -------- | --------------------------------- |\n| `id`              | Unique identifier for the user.                                            | Yes          | String   | `'unique_user_id'`                |\n| `customVariables` | Custom attributes for targeting.                                           | No           | Object   | `{ age: 25, location: 'US' }`     |\n\n#### Example\n\n```dart\nfinal userContext = VWOUserContext(\n    id: USER_ID,\n    customVariables: {\n        \"age\": 25,\n        \"location\": \"US\"\n    }\n);\n```\n\n### Basic Feature Flagging\n\nFeature Flags serve as the foundation for all testing, personalization, and rollout rules within FME.\nTo implement a feature flag, first use the `getFlag` API to retrieve the flag configuration.\nThe `getFlag` API provides a simple way to check if a feature is enabled for a specific user and access its variables.\n\n| Parameter    | Description                                                      | Required | Type   | Example                                                                               |\n| ------------ |------------------------------------------------------------------| -------- | ------ |---------------------------------------------------------------------------------------|\n| `featureKey` | Unique identifier of the feature flag                            | Yes      | String | `'new_checkout'`                                                                      |\n| `context`    | Object containing user identification and contextual information | Yes      | Object | `VWOUserContext()`                                                                    |\n\nExample usage:\n\n```dart\nfinal featureFlag = await vwoClient?.getFlag(\n  featureKey: \"featureKey\",\n  context: context,\n);\n\nif (featureFlag != null) {\n  // Get the flag value\n  final isFeatureFlagEnabled = featureFlag.isEnabled();\n\n  // Get the variable value for the given variable key and default value\n  final variable = featureFlag.getVariable(\"feature_flag_variable\", \"default-value\") as String;\n}\n```\n\n### Custom Event Tracking\n\nFeature flags can be enhanced with connected metrics to track key performance indicators (KPIs) for your features. These metrics help measure the effectiveness of your testing rules by comparing control versus variation performance, and evaluate the impact of personalization and rollout campaigns. Use the `trackEvent` API to track custom events like conversions, user interactions, and other important metrics:\n\n| Parameter         | Description                                                            | Required | Type   | Example                                     |\n| ----------------- | ---------------------------------------------------------------------- | -------- | ------ |---------------------------------------------|\n| `eventName`       | Name of the event you want to track                                    | Yes      | String | `'purchase_completed'`                      |\n| `context`         | Object containing user identification and other contextual information | Yes      | Object | `VWOUserContext()`                          |\n| `eventProperties` | Additional properties/metadata associated with the event               | No       | Object | `{\"amount\": 10}`                            |\n\nExample usage:\n\n```dart\nfinal context = VWOUserContext(\n    id: userId\n);\nfinal properties = {\"cartvalue\": 10};\n\nawait vwoClient.trackEvent(\n  eventName: \"event-name\",\n  context: context,\n  eventProperties: properties,\n);\n```\n\n### Pushing Attributes\n\nUser attributes provide rich contextual information about users, enabling powerful personalization. The `setAttribute` method provides a simple way to associate these attributes with users in VWO for advanced segmentation. Here's what you need to know about the method parameters:\n\n| Parameter        | Description                                                            | Required | Type   | Example                 |\n|------------------|------------------------------------------------------------------------| -------- |--------|-------------------------|\n| `attributes`     | Map of attribute key and value to be set                               | Yes      | Object | `{\"price\": 99}`         |\n| `context`        | Object containing user identification and other contextual information | Yes      | Object | `VWOUserContext()`      |\n\nExample usage:\n\n```dart\nfinal context = VWOUserContext(\n    id: userId\n);\nfinal attributes = {\"price\": 99};\nawait vwoClient?.setAttribute(\n  attributes: attributes,\n  context: context,\n);\n```\n\n### Polling Interval Adjustment\n\nThe `pollInterval` is an optional parameter that allows the SDK to automatically fetch and update settings from the VWO server at specified intervals. Setting this parameter ensures your application always uses the latest configuration.\n\n```dart\n\nfinal vwoInitOptions = VWOInitOptions(\n        sdkKey: SDK_KEY,\n        accountId: ACCOUNT_ID,\n        pollInterval: 60000\n)    \n\n// Create VWO instance with the vwoInitOptions\nfinal vwoClient = await VWO.init(vwoInitOptions);\n```\n\n### Logger\n\nVWO by default logs all `ERROR` level messages to the console. To gain more control over VWO's logging behavior, you can use the `logger` parameter in the `init` configuration.\n\n| **Parameter** | **Description**                        | **Required** | **Type** | **Example**           |\n| ------------- | -------------------------------------- | ------------ | -------- | --------------------- |\n| `level`       | Log level to control verbosity of logs | Yes          | String   | `TRACE`               |\n| `transports`  | Custom logger implementation           | No           | Object   | See example below     |\n\n#### Example: Implement custom logger\n\nThe `transports` parameter allows you to implement custom logging behavior by providing your own logging functions. You can define handlers for different log levels (TRACE, DEBUG, INFO, WARN, ERROR) to process log messages according to your needs.\n\n```dart\n// Create a custom logger implementation\nclass DartLogger implements LogTransport {\n  @override\n  void log(String level, String? message) {\n    if (message == null) return;\n    print(\"FME-Flutter: [$level] $message\");\n  }\n}\n\n// Configure logger in VWO initialization\nvar transport = \u003cString, dynamic\u003e{};\ntransport[\"defaultTransport\"] = DartLogger();\n\nvar logger = \u003cMap\u003cString, dynamic\u003e\u003e[];\nlogger.add(transport);\n\nfinal vwoInitOptions = VWOInitOptions(\n  sdkKey: SDK_KEY,\n  accountId: ACCOUNT_ID,\n  logger: {\"level\": \"TRACE\", \"transports\": logger},\n);\n\nfinal vwoClient = await VWO.init(vwoInitOptions);\n```\n\n## Authors\n\n* [Swapnil Chaudhari](https://github.com/swapnilWingify)\n\n### Version History\n\nThe version history tracks changes, improvements and bug fixes in each version. For a full history, see the [CHANGELOG.md](https://github.com/wingify/vwo-fme-flutter-sdk/blob/master/CHANGELOG.md).\n\n## Contributing\n\nWe welcome contributions to improve this SDK! Please read our [contributing guidelines](https://github.com/wingify/vwo-fme-flutter-sdk/blob/master/CONTRIBUTING.md) before submitting a PR.\n\n## Code of Conduct\n\n[Code of Conduct](https://github.com/wingify/vwo-fme-flutter-sdk/blob/master/CODE_OF_CONDUCT.md)\n\n## License\n\n[Apache License, Version 2.0](https://github.com/wingify/vwo-fme-flutter-sdk/blob/master/LICENSE)\n\nCopyright (c) 2024-2025 Wingify Software Pvt. Ltd. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwingify%2Fvwo-fme-flutter-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwingify%2Fvwo-fme-flutter-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwingify%2Fvwo-fme-flutter-sdk/lists"}