Features, experiments and events

Feature flags and experiments, event collection, URL redirect and visual experiments.

API v1Updated Oct 22, 2026

Read Feature flags

flags.tsTypeScript

1import { createIndiana } from "@tinkerlandai/indiana-sdk";2 3const indiana = createIndiana({4  baseUrl: "https://api.tinker.cash",5  scope: { projectId: "<APP_UUID>", environment: "sandbox" },6});7 8export async function loadFlags(9  customerToken: string,10  customer: { id: string; externalUserId: string | null },11) {12  indiana.identify(customerToken);13  const identity = { id: customer.id, externalUserId: customer.externalUserId };14  const flags = await indiana.features({ attributes: { ...identity, country: "CA" } });15  const enabled = flags.getFeatureValue("new-checkout", false);16  const unsubscribe = flags.subscribe(() => console.log(flags.isOn("new-checkout")));17  indiana.track("Checkout Viewed", { source: "pricing" });18  await indiana.flush();19  return { enabled, stop: () => (unsubscribe(), flags.destroy()) };20}

Pass id (the Customer UUID) and externalUserId so a user gets the same experiment variation everywhere.
setAttributes() replaces all attributes; keep these two fields on every update.
Backends can read and evaluate with getFeatures or evaluateFeatures (features:read).

Track events

track(name, properties) records a behavior event and flush() sends it. Experiment exposures and Feature usage are recorded automatically; each kind can be turned on or off per environment in Console.

Website experiments

Load URL redirect and visual experiments on your pages without a credential. Copy the environment UUID from the experiment pages in Console.

experiments.tsTypeScript

1import { createPageExperiments } from "@tinkerlandai/indiana-sdk/page";2import { createVisualExperiments } from "@tinkerlandai/indiana-sdk/visual";3 4// The environment UUID is public; it selects published experiments and authenticates nothing.5const redirects = createPageExperiments({ environmentId: "<ENVIRONMENT_UUID>" });6const visual = createVisualExperiments({ environmentId: "<ENVIRONMENT_UUID>" });7 8export async function startExperiments() {9  await Promise.all([redirects.start(), visual.start()]);10}

Related operations

Features, evaluation and events (3): getFeatures, evaluateFeatures, trackEvents