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";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>
);
}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
| Prop | Type | Default | Description |
|---|---|---|---|
label | string | — | Names the secret. |
isSet | boolean | — | 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. |
revealTimeout | number | 15000 | Milliseconds on screen; 0 keeps it until hidden. It also hides when the tab is left. |
rotatedAt / today | string | — | “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. |
className | string | — | Extra classes. |