← Harku

Install guide

Add Harku to any site in under a minute — one script tag, no build step.

1. Create a project

Sign up for Harku and create a project for the site you want feedback on. Each project gets its own public key — a safe, public identifier you'll drop into the snippet.

2. Copy your snippet

On your project page, copy the install snippet — your public key is already filled in for you:

<script async src="https://harku-widget.vercel.app/loader.js" data-harku-key="YOUR_PUBLIC_KEY"></script>

3. Paste it into your site

Paste the snippet just before the closing </body> tag, on every page where you want the Feedback button. No build step, no SDK, no dependencies — the loader is tiny and loads asynchronously, so it never blocks your page.

The full widget only loads — in an isolated iframe — when a visitor actually opens it, so it stays light on your main thread.

Snippet options

The snippet accepts a few attributes:

  • data-harku-keyrequired. Your project's public key.
  • data-harku-theme — optional. light or dark for the first paint; your dashboard setting takes over once the config loads.
  • data-harku-api — advanced. Override the API base URL (for development or self-hosting).

Customize it from the dashboard

You never need to touch the snippet again to restyle the widget. From your project's appearance settings you can change:

  • Accent color — the Feedback button and highlights.
  • Position — bottom-right or bottom-left.
  • Theme — light or dark.

The widget re-reads these on every load, so changes appear the next time a visitor refreshes — no redeploy needed.

Read the docs →