liforma docs

Use a Public Experience

Step-by-step guide for public embeds.

Prerequisites

  • A Liforma experience marked as public
  • Your site's origin added to the experience 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. Deploy — ensure your production origin is allowlisted
  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

Troubleshooting

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

See Errors for HTTP status codes.