A flutter package that provides useful flutter utilities for clever_settings.

Add clever_settings_flutter and clever_settings to your pubspec.yaml:

dependencies: 
  clever_settings: ^[version]
  clever_settings_flutter: ^[version]

Install it:

flutter packages get

Before you can start using Clever Settings, you need to initialize it first. Call the init function once at the start of your application:

await CleverSettingsFlutter.init();

This will initialize Hive and open the settings database. If you want to configure Hive yourself, you can use CleverSettings.open() after initializing Hive.

This will only focus on the additional features of clever_settings_flutter. The readme for the basic usage of clever_settings can be found here.

The SettingsValueBuilder is a widget used for building other widgets that depend on a SettingsValue object. It rebuilds whenever the value of the setting changes.

Example:

class Settings {
  static const mySetting =
      SettingsValue<bool>(name: 'mySetting', defaultValue: true);
}

...

SettingsValueBuilder(
  setting: Settings.mySetting,
  builder: (context, value, child) {
    return Text(value.toString());
  },
),

The MultiSettingsValueBuilder is a widget that allows you to listen to and combine multiple SettingsValue objects to build a widget that depends on all of them.

Example:

MultiSettingsValueBuilder(
  settings: [
    Settings.mySetting,
    Settings.myOtherSetting,
  ],
  builder: (context, child) {
    // Updates when one of the settings changes.
    return Text('${Settings.mySetting.value} ${Settings.myOtherSetting.value}');
  },
)