Documentación
Cómo funciona Harku — el widget de feedback ligero que lleva una idea de la sugerencia hasta producción, desde un único script.
Qué es Harku
Harku es un widget de feedback embebible para devs indie y micro-SaaS. Pegas una línea de script en tu sitio —como instalar un chat— y tus usuarios pueden proponer ideas, votarlas, seguir un roadmap público y leer tu changelog.
Tú lo gestionas todo desde el dashboard de Harku: ordenas las sugerencias por votos, mueves cada una por su ciclo de vida y publicas novedades. Así se cierra el bucle: un usuario propone → tú priorizas → lo construyes → lo anuncias.
El widget
El widget es un pequeño botón flotante de Feedback que carga desde un único script asíncrono. Al pulsarlo se abre un panel dentro de un iframe aislado, así los estilos de tu sitio y los del widget nunca interfieren entre sí.
- Sugerencias — la lista de ideas, ordenada por votos, con upvote de un clic.
- Nueva sugerencia — un formulario corto (un título y una descripción opcional).
- Roadmap — lo planeado, en progreso y lanzado.
- Novedades — tus anuncios publicados, con un badge de no leídos.
El widget es de solo lectura salvo en dos acciones: crear una sugerencia y votar. Todo lo demás refleja lo que gestionas en el dashboard.
Voto anónimo
No hace falta registrarse para votar ni sugerir. Al cargar por primera vez, el widget genera un id aleatorio y lo guarda en el navegador del visitante, usándolo solo para evitar votos duplicados — la base de datos impone un voto por id y post. Los votos son optimistas (el contador sube al instante) y reversibles.
Como el id vive en el navegador, no está ligado a ninguna identidad y se puede borrar. Evita votos dobles casuales, no el abuso decidido.
El ciclo de vida
Cada sugerencia pasa por un estado que tú controlas desde el dashboard:
- Abierta — recién sugerida, juntando votos.
- Planeado — has decidido construirlo.
- En progreso — en marcha.
- Lanzado — hecho. No se borra nunca, así que sigue visible, y se puede enlazar a una entrada del changelog.
- Descartada — no planeada; se mantiene fuera del roadmap.
Cerrar el bucle
El roadmap público muestra Planeado, En progreso y Lanzado. El changelog es donde anuncias lo que aterrizó —opcionalmente enlazado a la sugerencia que lo pidió— para que quien votó vea su idea hecha realidad.
El dashboard
Entras con email y contraseña, creas un proyecto por cada sitio que tengas, y obtienes:
- Proyectos — uno por sitio, cada uno con su clave pública y su apariencia (color de acento, posición del botón, claro/oscuro).
- Sugerencias — ordenadas por votos; mueve cada una entre estados u oculta spam.
- Tablero de roadmap — un board con drag-and-drop donde también puedes añadir tus propios items.
- Editor de novedades — escribe anuncios, opcionalmente enlazados a una sugerencia lanzada.
Por dentro
El widget nunca habla con tu base de datos directamente. Llama a una pequeña API pública —validada por la clave pública de tu proyecto— para todo lo que hace: leer sugerencias, crear una, votar y traer tu config y tu changelog. Los datos del owner están protegidos por row-level security; solo se exponen las operaciones seguras y públicas.
¿Listo para añadirlo? Mira la guía de instalación.