App Desktop (PopinaFlow Desktop)
O PopinaFlow Desktop é um programa que você instala no computador do restaurante — sem precisar de Docker, servidor ou configuração técnica. Ele inclui tudo que precisa para funcionar: banco de dados, servidor e o sistema completo.
Quando instalado em modo servidor, qualquer celular ou tablet conectado ao Wi-Fi do restaurante consegue acessar o menu, fazer pedidos e usar o PDV — direto pelo navegador.
Quando usar o App Desktop?
- Restaurante sem internet ou com internet instável
- Não quer depender do servidor em nuvem
- Quer que clientes acessem o menu pelo celular (QR code) mesmo sem internet
- Prefere uma instalação simples, sem Docker
Instalação
- Baixe o instalador correspondente ao seu sistema:
- Windows:
PopinaFlow-Setup.exe - macOS:
PopinaFlow.dmg - Linux:
PopinaFlow.AppImage
- Windows:
- Abra o instalador e siga os passos (próximo, próximo, instalar)
- Abra o PopinaFlow pelo atalho criado na área de trabalho
Configuração inicial: escolha o modo
Na primeira abertura, o app pede para escolher como este computador vai funcionar:
Servidor local
Escolha esta opção no computador principal do restaurante (geralmente o caixa ou o computador do gerente).
Este computador vai:
- Guardar todos os dados do restaurante
- Servir o sistema para todos os outros dispositivos na rede
Terminal (cliente)
Escolha esta opção nos outros computadores do restaurante (terminais de PDV, computador da cozinha, etc).
Você vai precisar informar o IP do servidor — número exibido na tela do computador configurado como servidor.
Essa configuração é salva. Na próxima vez que abrir o app, ele vai direto para o sistema.
Modo Servidor: primeiros passos
Após escolher "Servidor local" e o sistema iniciar, você verá:
O endereço da rede
http://192.168.1.42:3000Este é o endereço que todos os dispositivos na mesma rede Wi-Fi podem usar para acessar o sistema.
O QR code
Um QR code é gerado automaticamente apontando para esse endereço. Você pode:
- Imprimir e colocar na mesa para clientes escanearem
- Mostrar na tela para clientes apontarem a câmera
Links para copiar
Dois botões de cópia ficam disponíveis:
| Link | Para quem |
|---|---|
http://IP:3000/t/[slug]/menu | Clientes (cardápio + pedido) |
http://IP:3000/t/[slug]/admin | Garçons e gerentes (PDV, admin) |
Substitua
[slug]pelo identificador do seu restaurante (ex:meu-restaurante). O sistema exibe o link correto depois do primeiro acesso.
Clique em "Entrar no sistema" para começar a usar.
Acessar de celular ou tablet
Em qualquer dispositivo conectado ao mesmo Wi-Fi do computador servidor:
- Abra o navegador (Chrome, Safari, Firefox)
- Digite o endereço exibido no app:
http://192.168.X.X:3000 - O sistema abre normalmente, como se fosse o site em nuvem
| Dispositivo | O que acessar |
|---|---|
| Celular do cliente | http://192.168.X.X:3000/t/[slug]/menu |
| Tablet do garçom | http://192.168.X.X:3000/t/[slug]/pdv |
| Computador da cozinha | http://192.168.X.X:3000/t/[slug]/kitchen |
| Computador do gerente | http://192.168.X.X:3000/t/[slug]/admin |
O número
3000faz parte do endereço — não se esqueça de incluí-lo.
O que funciona sem internet
O app desktop funciona completamente offline. Não é necessária conexão com a internet para nenhuma das operações do dia a dia:
| Funcionalidade | Sem internet |
|---|---|
| Cardápio digital (clientes) | ✅ Funciona |
| PDV e pedidos | ✅ Funciona |
| Mesas e comanda | ✅ Funciona |
| Display da cozinha | ✅ Funciona |
| Fechar conta / pagamento | ✅ Funciona |
| Reservas | ✅ Funciona |
| Emissão de NF-e / NFS-e | ❌ Requer internet |
| Upload de fotos de itens | ❌ Requer internet |
| Sincronização com a nuvem | ❌ Requer internet (não configurado por padrão) |
Parar e reiniciar
Para encerrar o servidor, feche o app PopinaFlow. Ao abrir novamente, o sistema reinicia automaticamente — sem precisar reconfigurar.
Os dados são salvos localmente no computador e não são perdidos ao fechar o app.
Solução de problemas
O app abre mas nada carrega
- Aguarde até 60 segundos na primeira abertura (o banco de dados está sendo iniciado)
- Se aparecer uma tela de erro com logs, anote a mensagem e entre em contato pelo Admin > Suporte
Outros dispositivos não conseguem acessar
- Verifique se estão na mesma rede Wi-Fi que o computador servidor
- Confirme que está digitando o endereço com a porta
:3000 - O IP pode mudar se o roteador reiniciar — reabra o app para ver o novo endereço
- No Windows: verifique se o Firewall do Windows está bloqueando a porta 3000
O IP do servidor não aparece
- O computador precisa estar conectado ao Wi-Fi ou cabo para ter um IP na rede
- Se não houver interface de rede ativa, o endereço não é exibido
Modo cliente não conecta
- Confirme que o computador servidor está com o app aberto e em execução
- Verifique se digitou o IP corretamente (sem
http://ou:3000— informe apenas o IP) - Ambos os computadores precisam estar na mesma rede
Esqueci em qual modo estava configurado
- Clique no menu do app → Redefinir modo para voltar à tela de configuração inicial
Dúvidas? Acesse o painel Admin > Suporte ou entre em contato em popinaflow.com.