Pub GitHub Workflow Status

Unleash Client SDK for Dart and Flutter

This is an unofficial Unleash Client SDK for Dart. It is compatible with the Unleash-hosted.com SaaS offering and Unleash Open-Source. It also works with GitLab Feature Flags.

Getting started

First, you will need to add unleash to your pubspec.yaml:

dependencies:
  unleash: x.y.z 
  # use the latest version found on pub.dev

Then, run flutter packages get in your terminal.

Create a new Unleash instance

It is easy to get a new instance of Unleash. In your app you typically just want one instance of Unleash, and inject that where you need it.

To create a new instance of Unleash you need to pass in a config object:

import 'package:unleash/unleash.dart';

Future<void> main() async {
  final unleash = await Unleash.init(
    UnleashSettings(
      appName: '<appname>',
      instanceId: '<instanceid>',
      unleashApi: Uri.parse('<api_url>'),
    ),
  );
  print(unleash.isEnabled('Awesome Feature'));
}

Awesome feature toggle API

It is really simple to use unleash.

if(unleash.isEnabled("AwesomeFeature")) {
  //do some magic
} else {
  //do old boring stuff
}

Calling unleash.isEnabled("AwesomeFeature") is the equivalent of calling unleash.isEnabled("AwesomeFeature", defaultValue: false). Which means that it will return false if it cannot find the named toggle.

If you want it to default to true instead, you can pass true as the second argument:

unleash.isEnabled("AwesomeFeature", defaultValue: true);

Current state of development

This client SDK supports version 3 of the API.

This SDK currently does not support any strategies, metrics reporting or anything else. It just gets the feature toggels yet.

Libraries

unleash
A dart client for Unleash. Unleash is a simple and easy to use feature toggle (also known as feature flags) service.