API Reference · Phase 5

Embedding.

Drop any tool into your site, blog, or docs portal with one line of HTML. Three modes — pick the friction level that matches your audience.

Status · Coming in Phase 5

The embed loader ships alongside the docs site. URLs and shape below are the contract — once the loader is live this page becomes the integration guide.

Iframe (universal)

Works everywhere. Classic sandboxed iframe.

<iframe
  src="https://toolsamurai.com/embed/pcb-design/pcb-trace-width"
  width="100%"
  height="420"
  frameborder="0"
></iframe>

Script embed (no iframe)

Drops a fully styled, interactive widget that respects the host site's width. No iframe sizing pain.

<div data-ts-tool="pcb-trace-width"></div>
<script src="https://toolsamurai.com/embed.js" async></script>

White-label embed

Team plan. Strips the ToolSamurai branding, lets you re-theme via query params or postMessage. Used for ERP tools, internal portals, SaaS products.

<iframe
  src="https://toolsamurai.com/embed/pcb-design/pcb-trace-width
       ?theme=dark&accent=%23ff6b35&hide_brand=true&key=sk_wl_•••"
></iframe>

postMessage events

The embed publishes ready, result, and error events on the parent window via postMessage. Always origin-check.