Skip to main content

LaunchDarkly Plugin

The LaunchDarkly plugin integrates feature-flag management directly into your Venue portal, allowing teams to view and monitor the state of feature flags for their services without leaving Venue.sh.

Preconfiguration: Generating an API Token​

To use the LaunchDarkly plugin in Venue.sh, you need a LaunchDarkly API access token with read access.

  1. Log in to your LaunchDarkly account, and navigate to Account Settings > Authorization.

  2. Click + Token in the Access tokens section.

  3. Give the token a name (e.g., venue-sh), and set the role to Reader.

  4. Click Save token.

  5. Copy and save the token in a secure location.

    tip

    LaunchDarkly displays the token only once. Make sure you save it before closing the dialog!

Configuring the LaunchDarkly Plugin in Venue.sh​

  1. In the Venue.sh app, click Plugins in the left-side navigation.
  2. Find LaunchDarkly, then click Enable Plugin.
  3. On the configuration modal, enter your LaunchDarkly API Token (generated above).
  4. Click Save Changes.

Component Setup​

Add the following annotations to your entity's catalog-info.yaml file to connect it to the relevant LaunchDarkly project and environment:

metadata:
  annotations:
    launchdarkly.com/project-key: [YOUR_PROJECT_KEY]
    launchdarkly.com/environment-key: [YOUR_ENVIRONMENT_KEY]
tip
  • Project key - Found in your LaunchDarkly dashboard under Account Settings > Projects. It is the short identifier (e.g., my-project).
  • Environment key - Found within a project's settings (e.g., production, staging).

Once configured, navigate to your entity in the Catalog, and click the LaunchDarkly tab to view the feature flags associated with that service.

Viewing Feature Flags​

The LaunchDarkly tab displays two sections, Project Overview and Context Overview.

Project Overview​

A table of all feature flags in the linked LaunchDarkly project, showing:

  • Name - The flag name
  • Maintainer - The user responsible for the flag
  • Kind - The flag type (e.g., boolean, multivariate, etc.)
  • Created - Date the flag was created
  • Version - The current flag version

Context Overview​

A detailed breakdown of each flag for the linked environment, showing:

  • Name / Key - The flag name and its unique key
  • Description - An optional description of the flag's purpose
  • Status - Whether the flag is currently enabled or disabled
  • Tags - Any tags associated with the flag
  • Variations - The individual variations and their enabled/disabled state

Expanding a flag also shows environment-targeting details for each environment in your LaunchDarkly project. Details include context targets, fallthrough variation, off variation, version, last modified date, and whether event-tracking is enabled.

Learn More​

Looking for more information? Check out the following resources: