Theming & copy

The hosted rendering models — embedded iframe and hosted page — accept a theme object and a strings object at mount (or via dashboard configuration).

Theme tokens

Token	Purpose
`primaryColor`	Your brand color, used for primary actions.
`borderRadius`	Corner rounding across the surface.
`mode`	`light` or `dark`.
`fontFamily`	Your font stack.
`inkColor`	Primary text color.
`mutedColor`	Secondary/muted text color.
`backgroundColor`	Surface background color.
`buttonTextColor`	Text color on primary buttons.
`lineColor`	Borders and dividers.
`successColor`	Success state color.
`dangerColor`	Error/danger state color.
`pageBackgroundColor`	Backdrop color behind the surface — used by the Tier B hosted page.
`density`	`"compact"` (default) or `"comfortable"` for roomier spacing.

Copy — `strings`

Override any copy with a strings object. Placeholders are substituted at render time:

{target}
{asset}
{assetAmount}
{network}

strings: { title: 'Add {target} to your safe' }

Attribution

A greyed-out “Powered by Pulse” renders at the foot of the surface by default. It is never mandatory — set attribution: "none" to remove it. No other Pulse branding is rendered in any tier.

Formatting helpers

@pulsebyshiga/collect-js exports the same formatting helpers the embed uses internally, so your own screens (rate previews, receipts, headless UI) format amounts identically:

formatFiat("1000000.00", "NGN") // → "₦1,000,000.00"
formatAsset(...)

Headless / API (Tier C)Dashboard configuration

Get started

Concepts

Backend integration

Render the payment moment

Testing & go-live

Theme tokens

Copy — `strings`

Attribution

Formatting helpers

​Theme tokens

​Copy — strings

​Attribution

​Formatting helpers

Theme tokens

Copy — `strings`

Attribution

Formatting helpers