Skip to content
Claudius
Search limited to v1.x. Switch to the latest version for up-to-date results.

Self-hosted embed

This content is for v1.x. Switch to the latest version for up-to-date documentation.

Self-hosting gives you full control (no third-party CDN in your CSP, custom Tailwind theme builds) at the cost of manual updates.

Build

Section titled “Build”
Terminal window
cd widget
pnpm install
pnpm build:embed
# Output: dist/claudius.iife.js and dist/claudius.css

Serve and embed

Section titled “Serve and embed”

Upload both files anywhere your site can reach them, then add before </body>:

<script>
  window.ClaudiusConfig = {
    apiUrl: "https://your-worker.workers.dev",
    title: "Support",
  };
</script>
<link rel="stylesheet" href="/claudius.css" />
<script src="/claudius.iife.js"></script>

Updating

Section titled “Updating”

Rebuild and re-upload on each release you want to adopt. The migration guides call out anything you need to change between versions — most releases are drop-in.