rollfuse
for developers

Start building with rollfuse

Everything you need to evaluate a flag from your own code: a quickstart, every SDK, and runnable examples for the stack you're already using.

Quickstart

  1. Create an account

    Sign up with Google and get a working Organization, Project, and Environment immediately.

  2. Confirm your environment

    Your first Environment is created for you at signup. Create additional ones (staging, production) from the console whenever you need them.

  3. Issue a credential

    Create a Service Credential scoped to your Environment from the console's Credentials screen. Its plaintext secret is shown exactly once.

  4. Make your first evaluation

    Install the SDK for your stack below, initialize it with the credential, and evaluate a flag. No network call on the hot path: the SDK evaluates locally against cached configuration.

Evaluate your first flag

npm install @rollfuse/sdk-js
import { RollfuseClient } from "@rollfuse/sdk-js";

const client = new RollfuseClient({
  baseUrl: "https://api.rollfuse.com",
  credential: process.env.ROLLFUSE_CREDENTIAL!,
});

await client.start();

const result = client.evaluate("user-42", "checkout-redesign", { fallback: false });

console.log(result.value);

Read the full quickstart

API reference

Browse every endpoint, parameter, request and response shape, and error response, generated directly from rollfuse's own OpenAPI contract.

Browse the API reference

SDKs and examples

Go backend

  • go-sdk

    The Go SDK: local, deterministic flag evaluation for server-side Go.

  • openfeature-provider

    Use the vendor-neutral OpenFeature Go SDK, backed by go-sdk underneath.

  • examples-go-prometheus

    A feature-flagged Go service instrumented with Prometheus, runnable end to end.

Node, browser, and React

  • js-sdk

    The JS/TS SDK family: server (sdk-js), browser (sdk-browser), and React bindings, in one monorepo.

  • examples-node-opentelemetry

    A feature-flagged Node.js service instrumented with OpenTelemetry, runnable end to end.

CI/CD and infrastructure

  • github-action

    The official GitHub Action: gate a workflow step on a rollfuse flag, a kill-switch pattern.

  • examples-github-actions

    A deploy kill-switch example wiring the GitHub Action into a real workflow.

  • examples-kubernetes

    Deploying a feature-flagged Go service on Kubernetes, verified against a real kind cluster.