Blocks / Secret field

Secret field

A hidden value: fixed-length mask, reveal for a few seconds, copy, replace, remove; set or not set.

import { SecretField, SECRET_MASK, SECRET_REVEAL_MS, secretProblem } from "@forgeron/ui";
/01 → Default
Signing secretSetChanged 18 days ago

Used to sign every request we send you.

••••••••••••
import { SecretField } from "@forgeron/ui";
import { useState } from "react";

export default function Default() {
  const [rotated, setRotated] = useState("2026-11-01");
  return (
    <div style={{ width: "100%", maxWidth: 560 }}>
      <SecretField
        label="Signing secret"
        hint="Used to sign every request we send you."
        isSet
        rotatedAt={rotated}
        today="2026-11-19"
        // The value is a placeholder, read only when asked for.
        getValue={() => "fg_test_xxxxxxxx"}
        onReplace={() => setRotated("2026-11-19")}
        onRemove={() => {}}
      />
    </div>
  );
}
/02 → Not set
Client secretNot set
Nothing stored yet.
import { SecretField } from "@forgeron/ui";
import { useState } from "react";

export default function NotSet() {
  const [set, setSet] = useState(false);
  return (
    <div style={{ width: "100%", maxWidth: 560 }}>
      <SecretField
        label="Client secret"
        isSet={set}
        {...(set
          ? { rotatedAt: "2026-11-19", today: "2026-11-19", value: "fg_test_yyyyyyyy" }
          : {})}
        onReplace={() => setSet(true)}
        onRemove={() => setSet(false)}
      />
    </div>
  );
}
API → Props
PropTypeDefaultDescription
labelstring—Names the secret.
isSetboolean—Not set shows a badge and Set value.
getValue / value() => string | Promise<string>; string—Where the value comes from, read only on Reveal or Copy. Hidden, it is never in the page.
revealTimeoutnumber15000Milliseconds on screen; 0 keeps it until hidden. It also hides when the tab is left.
rotatedAt / todaystring—“Changed 3 days ago”.
onReplace(value) => void | Promise<void>—The new value goes out and is not kept.
onRemove / onCopy() => void—Remove asks a second time.
classNamestring—Extra classes.