Repolode
Enviar
PanSalut

PanSalut/Koffan

Aplicación web autoalojada para compartir listas de compras entre familias y hogares, con sincronización en tiempo real y modo sin conexión.

Alternativa open source a:AnyListGoogle Keep

Ver en GitHub
Estrellas
824
Forks
85
Issues abiertos
50
Último commit
hace 21 días

¿Qué es?

Koffan es una aplicación web ligera para gestionar listas de compras en equipo. Varias personas pueden editar las mismas listas desde distintos dispositivos, y los cambios se sincronizan en tiempo real mediante WebSocket para que todos puedan ver qué falta y qué ya está en el carrito.

Funciona en cualquier navegador, tanto en móviles como en computadoras, y se puede instalar como PWA. Las listas se pueden dividir en secciones, como lácteos o limpieza; los productos se pueden marcar como comprados o dudosos, y el autocompletado sugiere artículos del historial. Las listas se pueden crear, editar y marcar como completadas sin conexión, y los cambios pendientes se sincronizan cuando vuelve la conexión.

De forma predeterminada, usa una sola contraseña compartida. Al establecer MULTI_USER=true, se habilitan las cuentas personales y los espacios de trabajo separados, para que varios hogares puedan compartir un servidor. El backend en Go usa SQLite para almacenar los datos, y el proyecto ofrece una REST API y webhooks salientes firmados para integraciones.

Funciones clave

  • 01Sincronización en tiempo real de listas compartidas entre dispositivos mediante WebSocket
  • 02Creación y edición sin conexión, con sincronización automática al reconectarse
  • 03Secciones, iconos personalizados para las listas y varias listas
  • 04Autocompletado basado en el historial de compras
  • 05Cuentas personales y espacios de trabajo separados opcionales
  • 06REST API y webhooks salientes firmados

Casos de uso

  • Una pareja o familia que crea una lista de compras compartida desde distintos teléfonos
  • Compartir un servidor autoalojado entre varios hogares con listas separadas
  • Sincronizar artículos de compras con herramientas de automatización como n8n o Zapier mediante webhooks
  • Usar la lista sin conexión en una tienda con poca señal

Inicio rápido

  1. 1

    Inicia Koffan con Docker usando el comando de inicio rápido del README

    docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest
  2. 2

    Abre http://localhost:3000 en el navegador e inicia sesión con tu contraseña

Antes de usarlo

  • El README no indica claramente una licencia de código abierto, así que consulta las condiciones de licencia del repositorio antes de reutilizarlo.
  • La compatibilidad sin conexión requiere servir Koffan mediante HTTPS, ya que HTTP sin cifrar en una red doméstica no la ofrece.
  • La actualización a 2.16.0 migra la base de datos y no permite volver a una versión anterior, así que haz una copia de seguridad de la base de datos antes.

En colecciones

Apps autoalojadasHerramientas de privacidad y local-firstBases de datos y herramientas SQL

Temas

#shopping-list#self-hosted#pwa#real-time#offline-first#go#sqlite#htmx

Preguntas frecuentes

¿Qué es Koffan?
Aplicación web autoalojada para compartir listas de compras entre familias y hogares, con sincronización en tiempo real y modo sin conexión. Koffan es una aplicación web ligera para gestionar listas de compras en equipo. Varias personas pueden editar las mismas listas desde distintos dispositivos, y los cambios se sincronizan en tiempo real mediante WebSocket para que todos puedan ver qué falta y qué ya está en el carrito.
¿Koffan es gratuito? ¿Qué licencia tiene?
Koffan es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Koffan sigue mantenido?
Mantenimiento activo. El último commit de Koffan fue el 16 oct 2026.
¿Para qué puedo usar Koffan?
Una pareja o familia que crea una lista de compras compartida desde distintos teléfonos Compartir un servidor autoalojado entre varios hogares con listas separadas Sincronizar artículos de compras con herramientas de automatización como n8n o Zapier mediante webhooks Usar la lista sin conexión en una tienda con poca señal
¿Cómo se instala Koffan?
Inicia Koffan con Docker usando el comando de inicio rápido del README: docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest Abre http://localhost:3000 en el navegador e inicia sesión con tu contraseña
¿Dónde consigo Koffan?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/PanSalut/Koffan

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados