FeatureGate defines util methods for enabling or disabling features in development based on a flag in local storage. A global window.FeatureGate object is made available in phoenix that can be called anytime after AppStart.

For Eg. You may have an extensions in development that colors phoenix in red. But you are working on a new feature that makes other colors available, but not yet ready for use. So put the extension behind a named feature gate so that only people who want to test the extension will be able to use it.

// within extensions
const FeatureGate = brackets.getModule("utils/FeatureGate"); // replace with `require` for core modules.
const FEATURE_NEW_COLORS = 'myExtension.newColors';
FeatureGate.registerFeatureGate(FEATURE_NEW_COLORS, false); // false is the default value

Once the feature is registered, use the below code to check if the feature can be safely enabled. For Eg., if you want to enable fancy colors based on the example above:

if(FeatureGate.isFeatureEnabled(FEATURE_NEW_COLORS)){
   // do fancy colors here
}

1. Open developer tools > local storage
2. Add a new key with the key you have specified for the feature gate. In the above Eg., the key is myExtension.newColors
3. set the value in local storage to enabled to enable the feature or anything else to disable.

Registers a named feature with the default enabled state.

Type: function

• featureName string
• enabledDefault boolean

To register a feature gate with name myExtension.newColors

const FEATURE_NEW_COLORS = 'myExtension.newColors';
FeatureGate.registerFeatureGate(FEATURE_NEW_COLORS, false); // false is the default value here

Returns an array of all named registered feature gates.

Type: function

Returns [String] list of registered features

Returns true is an featureGate is enabled either by default or overridden by the user using local storage.

Type: function

• featureName string

To check if the feature myExtension.newColors is enabled

const FEATURE_NEW_COLORS = 'myExtension.newColors';
if(FeatureGate.isFeatureEnabled(FEATURE_NEW_COLORS)){
   // do fancy colors here
}

Returns boolean

Sets the enabled state of a specific feature in the application.

• featureName string The name of the feature to be modified.
• isEnabled boolean A boolean flag indicating whether the feature should be enabled (true) or disabled (false).