Feature Flags

Twill Capsule

Description

This Capsule allows you to easily enable/disable features on your application. Features not flagged to be available publicly will still be available on non-public domains. This way company staff and QA teams can still test these features on hiden domains, even if they are served by the same server/database.

Installing

Require the Composer package:

composer require area17/twill-feature-flags

Enable the Capsule in config/twill.php:

    'capsules' => [
        'list' => [
            [
                'name' => 'FeatureFlags',
                'enabled' => true,
            ],
            ...

Load Capsule helpers by adding calling the loader to your AppServiceProvider:

/**
 * Register any application services.
 *
 * @return void
 */
public function register()
{
    \A17\TwillFeatureFlags\Services\Helpers::load();
}

Add a configuration to config/app.php, to set your public available domains

/*
|--------------------------------------------------------------------------
| Domains
|--------------------------------------------------------------------------
|
*/

'domains' => [
    'publicly_available' => explode(',', env('PUBLICLY_AVAILABLE_DOMAINS')),
],

Add the production domains list (comma separated) to your .env file:

PUBLICLY_AVAILABLE_DOMAINS=my-production-domain.com

Using

Once installed and configured, you can go to https://your-domain/featureFlags to create/enable/disable feature flags.

And, on your code, you can just use the helper to show/hide features from your website:

if (feature('booking')) {
    // whatever your feature has to do
}

Or in Blade:

@include('partials.global.head', ['noIndex' => !feature('feature-x')])

@if(feature('booking'))
    // Render the feature
@endif

Don't forget to add the feature flags to your navigation too.