sambarannnn/flutter-client-sdk

LaunchDarkly Client-side SDK for Flutter mobile applications

LaunchDarkly Client-side SDK for Flutter

LaunchDarkly overview

LaunchDarkly is a feature management platform that serves trillions of feature flags daily to help teams build better software, faster. Get started using LaunchDarkly today!

Supported Platforms

See the pubspec.yaml file for Flutter version requirements.

This SDK supports Android, iOS, Linux, macOS, Web, and Windows.

The underlying API support requirements are determined by the native plugins used by the SDK.

These include:

• shared_preferences: Used for persistent caching for flag payloads and other data.
• connectivity_plus: Used for detecting network status.
• package_info_plus and device_info_plus: Used to for the automatic environment attributes feature.

Getting started

Refer to the SDK documentation for instructions on getting started with using the SDK.

Organization

The repository is a monorepo containing the packages required to make the SDK as well as testing and example applications.

Directory	Readme	Description
.github		Contains CI and release process workflows and actions.
packages		Contains flutter/dart libraries.
packages/flutter_client_sdk	Flutter Client SDK	Package which implements the LaunchDarkly client-side SDK for flutter.
packages/common	Common	Package which contains common code for dart based SDKs. Currently there is only a client-side SDK, but this directory should only contain code tha would apply to both client and server-side SDKs.
packages/client	Common Client	Package containing code that is specific to client-side SDKs, but not specific to flutter.
packages/event_source_client	Event Source Client	Package implementing support for SSE.
apps		Contains sample and test applications.
apps/sse_contract_test_service	SSE Contract Test Service	This application is used to test the SSE implementation used by the SDK.
apps/flutter_client_contract_test_service	Flutter Client Contract Test Service	This application is used to test the functionality of the SDK.
architecture		Contains diagrams and other supporting architecture documents.

Learn more

Read our documentation for in-depth instructions on configuring and using LaunchDarkly. You can also head straight to the complete reference guide for this SDK or our code-generated API documentation.

Testing

We run integration tests for all our SDKs using a centralized test harness. This approach gives us the ability to test for consistency across SDKs. These tests cover each method in the SDK, and verify that event sending, flag evaluation, stream reconnection, and other aspects of the SDK all behave correctly.

Contributing

We encourage pull requests and other contributions from the community. Read our contributing guidelines for instructions on how to contribute to this SDK.

About LaunchDarkly

• LaunchDarkly is a feature management platform. We empower all teams to deliver and control their software. With LaunchDarkly, you can:
  • Roll out a new feature to a subset of your end users, such as a group of end users who opt in to a beta tester group, and gather feedback and bug reports from real-world use cases.
  • Gradually roll out a feature to an increasing percentage of customers, and track the effect that the feature has on key metrics. For instance, how likely is a customer to complete a purchase if they have feature A versus feature B?
  • Turn off a feature that is causing performance problems in production, without needing to re-deploy or even restart the application with a changed configuration file.
  • Grant access to certain features based on end user attributes, like payment plan. (For example, customers on the ‘gold’ plan have access to more features than customers in the ‘silver’ plan).
  • Disable parts of your application to facilitate maintenance, without taking everything offline.
• LaunchDarkly provides feature flag SDKs for a wide variety of languages and technologies. Read our SDK documentation for a complete list.
• Explore LaunchDarkly
  • launchdarkly.com for more information
  • docs.launchdarkly.com for our documentation and SDK reference guides
  • apidocs.launchdarkly.com for our API documentation
  • launchdarkly.com/blog for the latest product updates