@geenius/feature-flags

Runtime feature toggles, rollout controls, and experiment tooling for Geenius applications.

Installation

pnpm add @geenius/feature-flags

Install the peers required by the variant you render with:

• react and react-dom for @geenius/feature-flags/react and @geenius/feature-flags/react-css
• solid-js for @geenius/feature-flags/solidjs and @geenius/feature-flags/solidjs-css
• convex for @geenius/feature-flags/convex

Imports

import { evaluateFlag, RULE_OPERATORS } from "@geenius/feature-flags";
import { evaluateFlag, RULE_OPERATORS } from "@geenius/feature-flags/shared";
import { FeatureFlagsPage, FlagDetailPage } from "@geenius/feature-flags/react";
import {
  FeatureFlagsPage as CssFeatureFlagsPage,
  FlagToggle as CssFlagToggle,
} from "@geenius/feature-flags/react-css";
import {
  createFeatureFlags,
  FeatureFlagsPage as SolidFeatureFlagsPage,
} from "@geenius/feature-flags/solidjs";
import {
  createFeatureFlags as createCssFeatureFlags,
  FlagToggle as SolidCssFlagToggle,
} from "@geenius/feature-flags/solidjs-css";
import { schema, queries, mutations } from "@geenius/feature-flags/convex";

Usage

import {
  FeatureFlagsPage,
  type FeatureFlagsAdminMutations,
} from "@geenius/feature-flags/react-css";

const mutations: FeatureFlagsAdminMutations = {
  createFlag: async () => "flag_new",
  updateFlag: async () => undefined,
  enableFlag: async () => undefined,
  disableFlag: async () => undefined,
  deleteFlag: async () => undefined,
  updateRollout: async () => undefined,
  setTargetRules: async () => undefined,
};

export function FeatureFlagsRoute() {
  return (
    <FeatureFlagsPage
      flags={flags}
      onToggle={async (id, enabled) => updateFlag(id, { enabled })}
      onEdit={(id) => openFlagDetail(id)}
      onCreate={() => openCreateDialog()}
      mutations={mutations}
    />
  );
}

Storybook

The public repository includes React and SolidJS preview hosts for reviewing the Tailwind and vanilla CSS variants side by side:

• Repository: geenius-dev/geenius-feature-flags
• Preview focus: feature-flag pages, rollout controls, targeting editors, and developer override tooling

Both preview hosts render the same authored scenarios so visual and behavioral parity stays reviewable across frameworks and styling variants.

Package Contract

• @geenius/feature-flags and @geenius/feature-flags/shared expose the framework-agnostic evaluation engine.
• @geenius/feature-flags/react and @geenius/feature-flags/solidjs expose Tailwind-oriented UI and reactive bindings.
• @geenius/feature-flags/react-css and @geenius/feature-flags/solidjs-css expose standalone vanilla CSS implementations plus stylesheet subpaths.
• @geenius/feature-flags/convex exposes the Convex schema, queries, mutations, and validators.

License

MIT