domain
SDK

Dialog configuration

Locale, branding, setup policy, DKIM guidance, and safe copy controls.

All configuration is validated by Domain0ConnectConfigurationSchema before the dialog is mounted.

Locale

await domain0.connectDomain({
  client,
  connectionId,
  locale: 'de',
})

Supported locale identifiers are exported by Domain0LocaleSchema. Incomplete native catalogs fall back to English explicitly instead of guessing a locale.

White label

await domain0.connectDomain({
  client,
  connectionId,
  applicationName: 'Acme Cloud',
  whiteLabel: {
    logo: 'https://app.acme.com/brand/logo.svg',
    theme: {
      colorMode: 'system',
      light: { primary: '#172554', onPrimary: '#ffffff' },
      widthPx: 680,
      dialogRadiusPx: 16,
    },
    copy: {
      successTitle: { en: '{DOMAIN} is connected' },
      successButton: { en: 'Return to Acme' },
    },
  },
})

Theme values are semantic, bounded tokens—not arbitrary CSS. Copy is plain text, has an English fallback, and supports only documented placeholders.

Force guided manual setup

await domain0.connectDomain({
  client,
  connectionId,
  setupPolicy: { mode: 'manual' },
})

Manual mode never asks for provider credentials. It renders the exact effective records and still waits for authoritative DNS verification.

DKIM guidance

await domain0.connectDomain({
  client,
  connectionId,
  enableDkim: true,
  dkimSelectors: ['mail-2026'],
})

DKIM guidance reports bounded DNS evidence and links to fixed official provider material. It does not claim that signing is enabled in the provider account.

On this page