← Harku

Guide d'installation

Ajoute Harku à n'importe quel site en moins d'une minute — colle une balise script avant </body>. Aucun build step, aucun SDK, aucune dépendance, et ça se charge de façon asynchrone pour ne jamais bloquer ta page.

1. Crée un projet

Inscris-toi sur Harku et crée un projet pour le site dont tu veux du feedback. Chaque projet obtient sa propre clé publique — un identifiant public et sûr que tu inséreras dans le snippet.

2. Copie ton snippet

Sur la page de ton projet, copie le snippet d'installation — ta clé publique est déjà remplie pour toi :

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

3. Colle-le dans ton site

Colle le snippet juste avant la balise fermante </body>, sur chaque page où tu veux le bouton Feedback. Aucun build step, aucun SDK, aucune dépendance — le loader est minuscule et se charge de manière asynchrone, donc il ne bloque jamais ta page.

Le widget complet se charge — dans un iframe isolé — uniquement quand un visiteur l'ouvre, donc il reste léger sur ton thread principal.

Options du snippet

Le snippet accepte quelques attributs :

  • data-harku-key — obligatoire. La clé publique de ton projet.
  • data-harku-theme — optionnel. light ou dark pour le premier rendu ; ton réglage du dashboard prend le relais une fois la config chargée.
  • data-harku-api — avancé. Remplace l'URL de base de l'API (pour le développement ou le self-hosting).

Personnalise-le depuis le dashboard

Tu n'as plus jamais besoin de toucher le snippet pour restyliser le widget. Depuis les paramètres d'apparence de ton projet, tu peux modifier :

  • Couleur d'accentuation — le bouton Feedback et les mises en évidence.
  • Position — en bas à droite ou en bas à gauche.
  • Thème — clair ou sombre.

Le widget relit ces réglages à chaque chargement, donc les modifications apparaissent la prochaine fois qu'un visiteur actualise la page — aucun redéploiement nécessaire.

Lire la documentation →