Repolode
Enviar
PanSalut

PanSalut/Koffan

App web auto-hospedado de lista de compras compartilhada para famílias e moradores da mesma casa, com sincronização em tempo real e modo offline.

Alternativa open source a:AnyListGoogle Keep

Ver no GitHub
Estrelas
825
Forks
85
Issues abertas
50
Último commit
há 22 dias

O que é?

Koffan é um aplicativo web leve para gerenciar listas de compras em conjunto. Várias pessoas podem editar as mesmas listas em dispositivos diferentes, e as alterações são sincronizadas em tempo real via WebSocket para que todos vejam o que ainda falta e o que já está no carrinho.

Ele funciona em qualquer navegador, no celular ou no computador, e pode ser instalado como PWA. As listas podem ser divididas em seções, como laticínios ou produtos de limpeza; os itens podem ser marcados como comprados ou incertos; e o preenchimento automático sugere itens do histórico. É possível criar, editar e marcar itens das listas offline, e as alterações pendentes são sincronizadas quando a conexão volta.

Por padrão, o app usa uma única senha compartilhada. Definir MULTI_USER=true habilita contas pessoais e espaços de trabalho separados, permitindo que várias famílias usem o mesmo servidor. O backend em Go usa SQLite para armazenamento, e o projeto oferece uma REST API e webhooks de saída assinados para integrações.

Recursos principais

  • 01Sincronização em tempo real de listas compartilhadas entre dispositivos via WebSocket
  • 02Criação e edição offline com sincronização automática ao reconectar
  • 03Seções, ícones personalizados para listas e várias listas
  • 04Preenchimento automático com base no histórico de compras
  • 05Contas pessoais opcionais e espaços de trabalho separados
  • 06REST API e webhooks de saída assinados

Casos de uso

  • Um casal ou uma família montando uma lista de compras compartilhada em celulares diferentes
  • Compartilhar um servidor auto-hospedado entre várias famílias, cada uma com suas próprias listas
  • Sincronizar itens de compras com ferramentas de automação, como n8n ou Zapier, via webhooks
  • Usar a lista offline dentro de uma loja com sinal fraco

Início rápido

  1. 1

    Inicie o Koffan com Docker usando o comando de início rápido do README

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

    Abra http://localhost:3000 no navegador e entre com sua senha

Antes de usar

  • O README não informa claramente uma licença de código aberto; por isso, confira os termos de licença do repositório antes de reutilizá-lo.
  • O suporte offline exige que o Koffan seja servido por HTTPS, pois o HTTP comum em uma rede doméstica não oferece esse recurso.
  • A atualização para a versão 2.16.0 migra o banco de dados e não permite voltar para uma versão anterior. Faça um backup do banco de dados antes.

Em coleções

Apps auto-hospedadosFerramentas de privacidade e local-firstBancos de dados e ferramentas SQL

Tópicos

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

Perguntas frequentes

O que é Koffan?
App web auto-hospedado de lista de compras compartilhada para famílias e moradores da mesma casa, com sincronização em tempo real e modo offline. Koffan é um aplicativo web leve para gerenciar listas de compras em conjunto. Várias pessoas podem editar as mesmas listas em dispositivos diferentes, e as alterações são sincronizadas em tempo real via WebSocket para que todos vejam o que ainda falta e o que já está no carrinho.
Koffan é gratuito? Qual é a licença?
Koffan é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
Koffan ainda é mantido?
Manutenção ativa. O último commit de Koffan foi em 16 de out. de 2026.
Para que posso usar Koffan?
Um casal ou uma família montando uma lista de compras compartilhada em celulares diferentes Compartilhar um servidor auto-hospedado entre várias famílias, cada uma com suas próprias listas Sincronizar itens de compras com ferramentas de automação, como n8n ou Zapier, via webhooks Usar a lista offline dentro de uma loja com sinal fraco
Como instalar Koffan?
Inicie o Koffan com Docker usando o comando de início rápido do README: docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest Abra http://localhost:3000 no navegador e entre com sua senha
Onde consigo Koffan?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/PanSalut/Koffan

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados