GovBuilt.FeatureFlags 1.0.5

GovBuilt.FeatureFlags

Private package — GovBuiltFeed only. Do not publish to nuget.org.

An Orchard Core module that stores per-tenant feature flag settings and provides the admin UI for managing them.

The module is the flag authority. It owns storage, the admin settings page, and the IFeatureFlagHelper DI registration. Consuming modules never write flags — they only read them via GovBuilt.FeatureFlags.Abstraction.

What this package does

• Stores feature flag settings per tenant using Orchard Core ISiteService
• Renders the admin settings page at Admin → Configuration → Settings → Feature Flags
• Registers IFeatureFlagHelper in the Orchard Core tenant DI container
• Protects the settings page with the ManageFeatureFlags permission (Administrators only by default)

What this package does NOT

• Expose any controllers or API endpoints
• Share flag state across tenants
• Require database migrations

Prerequisites

• .NET 8
• Orchard Core multi-tenant host
• GovBuilt.FeatureFlags.Abstraction (peer dependency — provides FeatureFlagSetting and IFeatureFlagHelper)

Installation

Step 1: Add the private feed (once per machine)

dotnet nuget add source "https://pkgs.dev.azure.com/MCCinnovations/_packaging/GovBuiltFeed/nuget/v3/index.json" \
  --name GovBuiltFeed \
  --username az \
  --password <PAT>

Step 2: Add the package to the host project

<PackageReference Include="GovBuilt.FeatureFlags" Version="1.0.5" />

No Startup wiring required — the module is discovered automatically by Orchard Core.

Adding a new feature flag

Only FeatureFlagSetting.cs in GovBuilt.FeatureFlags.Abstraction needs to change:

[FeatureFlagInfo(Title = "My Feature", Type = "General", HelpText = "Enables my feature.")]
public bool IsMyFeature { get; set; }

The driver (FeatureFlagSettingsDisplayDriver) and admin view both use reflection and pick up new properties automatically.

Important rules:

• Prefix all flag properties with Is
• All flags default to false (opt-in)
• Use Type to group flags in the admin UI filter dropdown
• Bump <Version> in both packages and publish after adding a flag

Publishing

dotnet pack src/GovBuilt.Core/GovBuilt.FeatureFlags/GovBuilt.FeatureFlags.csproj -c Release -o ./artifacts
dotnet nuget push ./artifacts/GovBuilt.FeatureFlags.*.nupkg --source GovBuiltFeed --api-key az