
De onde veio o bingo
O pedido veio da psicóloga clínica Tathiane Galvão (CRP 01/27841): um bingo visual para usar na estimulação cognitiva de idosos durante sessões terapêuticas. A ideia é a do bingo tradicional, com imagens no lugar dos números. Tudo funciona no navegador, sem cadastro ou backend para processar as partidas.
Gerar cartelas, sortear imagens e imprimir eram as tarefas principais. Para entender como isso deveria funcionar, também era preciso considerar quem usaria o bingo e onde:
- Os participantes podem ter limitações visuais ou motoras
- Os profissionais que conduzem a atividade nem sempre têm familiaridade com tecnologia
- Ambientes de aplicação (clínicas, centros de convivência) podem ter conectividade limitada
O trabalho que o aplicativo precisava resolver
Antes do aplicativo, o trabalho era manual: recortar imagens, colar em cartolina e fazer o sorteio físico. Funcionava, mas levava tempo. Para trocar o tema, por exemplo usando fotos familiares do paciente, era preciso refazer todo o material.
O aplicativo precisava permitir quatro coisas:
- Gerar automaticamente cartelas com imagens únicas
- Sortear imagens com legendas para exibir ao grupo
- Imprimir as cartelas em A4
- Criar temas personalizados com upload de imagens
Os dados ficam no navegador
O processamento acontece no navegador, sem autenticação ou banco de dados no servidor.
Nesse contexto, o profissional precisa abrir o bingo e começar a atividade. Um cadastro acrescentaria uma etapa, e depender da conexão durante a partida poderia interromper a sessão.
As cartelas geradas e o progresso do sorteio ficam no localStorage. Já as imagens personalizadas ficam no IndexedDB, em base64. O localStorage tem um limite de cerca de 5 MiB por origem; o IndexedDB permite armazenar volumes maiores, mas também está sujeito à cota definida pelo navegador. Depois do carregamento inicial, o bingo funciona offline.
Persistência com localStorage
Para salvar e recuperar as cartelas, o código usa localStorage:
export function saveGeneratedCards(key: string, cards: BingoCard[]) {
localStorage.setItem(key, JSON.stringify(cards));
}
export function getGeneratedCards(key: string): BingoCard[] {
const data = localStorage.getItem(key);
return data ? JSON.parse(data) : [];
}
Persistência com IndexedDB
Os bingos com imagens personalizadas são salvos no IndexedDB:
const db = await openDB('bingo-store', 1, {
upgrade(db) {
db.createObjectStore('custom-bingos');
},
});
await db.put('custom-bingos', bingoData, bingoId);
const bingo = await db.get('custom-bingos', bingoId);
Como os dados ficam no navegador, o aplicativo também permite exportar e importar os bingos personalizados em arquivos JSON. Assim, é possível levar um bingo para outro dispositivo ou compartilhar o arquivo com educadores e outros profissionais.
Imagens prontas ou um tema próprio
Modo padrão
O modo padrão vem com 16 imagens, divididas em quatro categorias: emoções, autocuidado, socialização e geral. Ao montar as cartelas 3×3, o algoritmo distribui as imagens de cada categoria proporcionalmente. Isso dá variedade às cartelas sem depender apenas de uma seleção aleatória.
Modo personalizado
Neste modo, o profissional pode enviar imagens próprias em PNG, JPG ou WebP, com limite de 5 MB por arquivo. O aplicativo converte as imagens para base64 e as guarda no IndexedDB. A versão inicial usava localStorage, e as imagens ultrapassavam facilmente o espaço disponível. A mudança para IndexedDB deu mais espaço, mantendo o armazenamento local.
São necessárias pelo menos 9 imagens para preencher a cartela 3×3. A recomendação é usar 16 para ter mais variedade. Depois de criar um bingo, dá para mudar o nome ou adicionar imagens sem refazer tudo.
Como evitar cartelas repetidas
Escolher as imagens aleatoriamente pode produzir cartelas idênticas. Com 16 imagens e 9 espaços por cartela, existem C(16,9) = 11.440 combinações possíveis. Ainda assim, é preciso conferir se uma combinação já foi usada.
O aplicativo calcula quantas cartelas únicas o conjunto de imagens permite e compara cada nova cartela com as que já existem. Este trecho faz o cálculo do limite:
function combination(n: number, k: number): number {
if (k > n || k < 0) return 0;
if (k === 0 || k === n) return 1;
if (k > n - k) k = n - k;
let result = 1;
for (let i = 0; i < k; i++) {
result = (result * (n - i)) / (i + 1);
}
return Math.floor(result);
}
export function getMaxUniqueCards(availableImages: BingoImage[]): number {
return combination(availableImages.length, CARD_SIZE);
}
A interface mostra esse limite conforme a quantidade de imagens:
- 9 imagens: 1 cartela única
- 10 imagens: 10 cartelas únicas
- 16 imagens: 11.440 cartelas únicas
Também dá para adicionar cartelas a um conjunto sem invalidar as que já foram impressas. As cartelas podem ser exportadas e importadas para usar em outras sessões.
O sorteio na TV ou no projetor
O sorteio foi pensado para exibição em um projetor ou TV. A imagem sorteada ocupa a tela inteira para que o grupo consiga vê-la. Um toque ou clique em qualquer área volta ao painel de controle.
Os IDs das imagens já sorteadas ficam no localStorage. Isso permite retomar a partida se alguém recarregar a página ou fechar o navegador por acidente:
const { currentImage, drawnImages, remainingCount, canDraw, draw, reset } =
useLottery(images, "bingo-standard-lottery");
Perguntas para quem conduz a atividade
Um painel lateral sugere perguntas para o profissional usar durante a atividade. Esse recurso foi solicitado porque nem todos os mediadores têm experiência com dinâmicas de estimulação cognitiva.
As cartelas continuam no papel
A impressão faz parte do uso do bingo. As cartelas continuam físicas para que os participantes possam manuseá-las e jogar no formato tradicional que já conhecem.
Na impressão, o layout usa:
- Bordas pontilhadas que indicam onde recortar
- Cantos retos para facilitar o corte com tesoura
- Elementos de navegação ocultos
- Formatação A4 padrão
@media print {
@page {
size: A4;
margin: 1cm;
}
}
Na tela, as cartelas têm sombras e bordas arredondadas. No papel, o estilo fica mais simples, com bordas tracejadas. A propriedade printMode do componente alterna entre essas duas versões.
Tecnologias usadas
Next.js 16, React 19, Tailwind CSS v4, Vitest, Cypress, Biome, lucide-react, shadcn/ui.
Acesso
O bingo está disponível em bingo.rafikmoreira.dev.br, com acesso gratuito e sem restrições.