> For the complete documentation index, see [llms.txt](https://shoppad.gitbook.io/yedric/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shoppad.gitbook.io/yedric/developers.md).

# Developers

## Widget

The widget is a single script tag and a web component, no build step, no dependencies. Add it to your page and it just works. From there you can theme it, wire up JavaScript events, or lock sessions to individual users with HMAC signing.

* [Embedding the Widget](/yedric/developers/embedding-widget.md): quick start, attribute reference, common mistakes
* [Secure Mode](/yedric/developers/secure-mode.md): HMAC signing to scope sessions per user; Node / PHP / SubtleCrypto examples
* [Advanced Configuration](/yedric/developers/advanced-configuration.md): theming, layout, iframe/Shopify, client-side tool handling, programmatic open, debug
* [JavaScript API](/yedric/developers/javascript-api.md): `window.Yedric` methods, events, TypeScript types
* [Client Events](/yedric/developers/client-events.md): report things that happen in your own UI to the assistant, and let it react
* [MCP Server](/yedric/developers/mcp-server.md): manage assistants and read conversation data from Claude Desktop, Claude Code, and other MCP clients
* [Webhooks](/yedric/developers/webhooks.md): subscribe to events, verify the signature, and handle retries
* [Custom Apps](/yedric/developers/custom-apps.md): render your own panel beside a conversation