Installation

Install Aura Home SDK

Embed Aura Home by creating a container and initializing the SDK with the runtime URL for the target environment.

Install the Package

npm install @aura-home/sdk

Create a Host Container

<div id="aura-home"></div>

Initialize the SDK

import { AuraHome } from "@aura-home/sdk";

const aura = AuraHome.init({
  container: "#aura-home",
  baseUrl: "https://your-aura-home-runtime.example/",
  sections: {
    chat: true,
    profile: true,
    navbar: false,
    footer: false,
    exploreTools: false,
    onboarding: false
  },
  theme: {
    id: "cadisa"
  }
});

aura.on("ready", () => {
  console.log("Aura Home is ready");
});

Container Sizing

For full chat embeds, size the iframe to the host slot and let the embedded chat own vertical scrolling inside the message area.

#aura-home {
  width: 100%;
  height: calc(100vh - 120px);
  min-height: 720px;
}
Use environment configuration for runtime URLs, approved theme ids, and allowed origins. Do not hard-code secrets in the customer page.