Installation

Install the Maestrio SDK in your project using your preferred package manager.

npm

npm install @maestrio/sdk

pnpm

pnpm add @maestrio/sdk

yarn

yarn add @maestrio/sdk

Script tag (CDN)

You can also load the SDK directly via a script tag. The UMD build exposes a global MaestrioSDK object.

<script src="https://unpkg.com/@maestrio/sdk/dist/maestrio-sdk.umd.cjs"></script>
<script>
  const sdk = MaestrioSDK.createMaestrio({
    apiKey: "your-api-key",
    baseUrl: "https://app.maestrio.ai",
    projectId: "your-project-id",
  });
</script>

Requirements

• Browser environment — the SDK uses the DOM to render the feedback widget
• ES2017+ — if using the ES module build, your bundler should target modern browsers

The SDK has minimal dependencies (lit for the web component, better-result for error handling) and adds ~15KB gzipped to your bundle.

Next step

Once installed, head to the Quick Start to initialize the SDK and show the feedback widget.