liforma docs

Use a browser embed

Client-side embed protected by an origin allowlist.

Prerequisites

  • Browser embeds enabled for your project
  • Your site's origin on the Origins allowlist
  • An experienceId (e.g. exp_…)

Steps

  1. Install the SDK — npm install @liforma/client or load the CDN script
  2. Add the component — pass your experienceId
  3. Allowlist origins — every production host that embeds the experience
  4. Test — open your page, grant microphone permission, speak

Checklist

  • Component has a sized container
  • Page is served over HTTPS in production
  • Origin matches allowlist exactly (scheme + host + port)
  • Browser supports Web Speech API for voice input

When to prefer a server session

If you already have a backend, mint with an API key on the server instead. Origins are the client-only path; they exist so third parties cannot embed your experience on unapproved sites.

Troubleshooting

If the experience fails to start, check the browser console. Common issues: origin not allowlisted (403), browser embeds disabled for the project, or microphone permission denied.

See Errors for HTTP status codes.