GovBuilt.FeatureFlags.Tenants 1.0.10

GovBuilt.FeatureFlags.Tenants

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

An Orchard Core module that provides a cross-tenant admin UI for managing feature flags across all running tenants from a single page.

Without this module, an administrator must log in to each tenant separately to toggle flags. With this module, the host admin can view and update every tenant's flags in one grid view, and the GovBuilt.FeatureFlags module is automatically enabled on any tenant where a flag is turned on.

What this module does

• Renders a Feature Flags Tenant grid at Admin → Configuration → Settings → Feature Flags Tenant
• Loads feature flag settings for all running tenants in parallel (capped concurrency to protect DB connection pools)
• Saves changes to multiple tenants simultaneously in a single Save action
• Auto-enables GovBuilt.FeatureFlags on any tenant where at least one flag is turned on
• Surfaces a warning banner for any tenant whose settings could not be loaded (DB error, misconfiguration), without crashing the page
• Protects the page with a dedicated ManageTenantFeatureFlags permission (Administrators only by default)

What this module does NOT

• Replace per-tenant flag management — each tenant still manages its own flags via GovBuilt.FeatureFlags
• Share flag state across tenants — each tenant's settings remain isolated
• Require database migrations
• Expose any API endpoints

Prerequisites

• .NET 8
• Orchard Core multi-tenant host
• GovBuilt.FeatureFlags module present in the host (peer dependency — owns per-tenant storage)
• GovBuilt.FeatureFlags.Abstraction (transitive — provides FeatureFlagSetting)

Installation

Step 1: Add the package to the host project

<PackageReference Include="GovBuilt.FeatureFlags.Tenants" Version="1.0.10" />

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

Step 2: Enable the feature

In the Orchard Core Admin → Features, search for GovBuilt.FeatureFlags.Tenants and enable it.

Admin UI

Feature Flags by Tenant page

The page renders a card grid where each card represents one flag × tenant combination.

Filter bar — three multi-select dropdowns at the top:

Card grid — each card shows:

• Toggle switch (click the switch or the flag title to toggle)
• Flag title and tenant name
• Type badge
• Help text (2-line clamp)

Pagination — 100 cards per page, navigated with Previous / Next / page number buttons.

Sticky Save bar — always visible at the bottom. Saves all changed toggles across all visible tenants in one request.

Architecture

File structure

GovBuilt.FeatureFlags.Tenants/
├── Controllers/
│   └── FeatureFlagTenantsController.cs   ← thin: auth + delegate to helper
├── Helpers/
│   ├── IFeatureFlagTenantHelper.cs        ← interface
│   └── FeatureFlagTenantHelper.cs         ← parallel load/save logic
├── ViewModels/
│   └── FeatureFlagTenantsViewModel.cs
├── Views/FeatureFlagTenants/
│   └── Index.cshtml
├── wwwroot/
│   ├── css/
│   │   ├── feature-flag-tenants.css
│   │   └── bootstrap-multiselect.css
│   └── js/
│       ├── feature-flag-tenants.js
│       └── bootstrap-multiselect.js
├── AdminMenu.cs
├── Permissions.cs
├── Startup.cs
└── Manifest.cs

Key types

Performance design for large tenant counts

The helper is built to handle 400+ tenants and 200+ flags without degrading:

Permissions

Auto-enable behaviour

When a flag is turned on for a tenant and saved, the module automatically enables GovBuilt.FeatureFlags on that tenant if it is not already enabled. This ensures consuming modules on that tenant can immediately read flag values via IFeatureFlagHelper without requiring manual feature activation.

force: true is passed to EnableFeaturesAsync so any declared dependencies of GovBuilt.FeatureFlags are also enabled automatically.

Publishing

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