Documentation
Comment fonctionne Harku — le widget de feedback léger qui mène une idée de la suggestion jusqu'au lancement, depuis un seul script.
Qu'est-ce que Harku
Harku est un widget de feedback intégrable pour les devs indés et les micro-SaaS. Tu colles une ligne de script dans ton site — comme installer un widget de chat — et tes utilisateurs peuvent proposer des idées, voter pour elles, suivre une roadmap publique et lire ton changelog.
Tu gères tout depuis le dashboard Harku : trie les suggestions par votes, fais évoluer chacune dans son cycle de vie et publie des annonces. Cela ferme la boucle — un utilisateur propose → tu priorises → tu construis → tu annonces.
Le widget
Le widget est un petit bouton flottant Feedback qui se charge depuis un seul script asynchrone. En cliquant dessus, un panneau s'ouvre dans un iframe isolé, donc les styles de ton site et ceux du widget ne s'interfèrent jamais.
- Suggestions — la liste des idées, triée par votes, avec upvote en un clic.
- Nouvelle suggestion — un formulaire court (un titre, plus une description optionnelle).
- Roadmap — ce qui est prévu, en cours et livré.
- Changelog — tes annonces publiées, avec un badge non lu.
Le widget est en lecture seule sauf pour deux actions : créer une suggestion et voter. Tout le reste reflète simplement ce que tu gères dans le dashboard.
Vote anonyme
Aucune connexion n'est requise pour voter ou suggérer. Au premier chargement, le widget génère un id aléatoire et le conserve dans le navigateur du visiteur, en l'utilisant uniquement pour empêcher les doubles votes — la base de données impose un vote par id par post. Les votes sont optimistes (le comptage se met à jour instantanément) et réversibles.
Comme l'id vit dans le navigateur, il n'est pas lié à une identité et peut être effacé. Il empêche les doubles votes occasionnels, pas les abus délibérés.
Le cycle de vie
Chaque suggestion passe par un statut que tu contrôles depuis le dashboard :
- Ouvert — nouvellement suggéré, en train de collecter des votes.
- Planifié — tu as décidé de le construire.
- En cours — en cours de réalisation.
- Livré — terminé. Il n'est jamais supprimé, donc il reste visible, et peut être lié à une entrée du changelog.
- Refusé — non planifié ; tenu hors de la roadmap.
Fermer la boucle
La roadmap publique affiche Planifié, En cours et Livré. Le changelog est l'endroit où tu annonces ce qui a atterri — optionnellement lié à la suggestion qui le demandait, pour que les personnes qui ont voté voient leur idée prendre vie.
Le dashboard
Connecte-toi avec e-mail et mot de passe, crée un projet pour chaque site que tu possèdes, et tu obtiens :
- Projets — un par site, chacun avec sa propre clé publique et son apparence (couleur d'accentuation, position du bouton, clair/sombre).
- Suggestions — triées par votes ; déplace chacune entre les statuts ou masque les spams.
- Board de roadmap — un board drag-and-drop où tu peux aussi ajouter tes propres éléments.
- Éditeur de changelog — écris des annonces, optionnellement liées à une suggestion livrée.
Sous le capot
Le widget ne parle jamais directement à ta base de données. Il appelle une petite API publique — validée par la clé publique de ton projet — pour tout ce qu'il fait : lire les suggestions, en créer une, voter et récupérer ta config et ton changelog. Les données du propriétaire sont protégées par la row-level security ; seules les opérations sûres et publiques sont exposées.
Prêt à l'ajouter ? Consulte le guide d'installation.