Poker entre Amigos
Mesa privada de Texas Hold'em No-Limit para um grupo fechado de amigos, direto no navegador.
Entrada só por convite, fichas 100% virtuais, voz no Discord por fora.
Estado atual: site público; tutorial com 10 módulos práticos (/tutorial); treino contra bots
do Fácil ao Extremo (/treino); XP, 30 níveis e 21 baralhos (/progresso, /baralhos). Tudo isso sem
login e sem internet (PWA). Com conta: convites, lobby com carteirinha, progresso sincronizado e
painel do dono (/admin). Mesas online vêm depois.
Para ativar as contas, siga docs/supabase.md. Progresso em docs/progresso.md.
Rodando localmente
Requisitos: Node 22.12+ e pnpm 12.
npm i -g pnpm@12
pnpm install
pnpm dev
O site abre em http://localhost:3000.
| Comando | O que faz |
|---|
pnpm dev | Sobe o site em modo desenvolvimento |
pnpm build | Build de produção |
pnpm lint | ESLint |
pnpm typecheck | Gera os tipos de rota do Next e roda o tsc |
pnpm test | Testes (Vitest) |
pnpm format | Prettier |
Sem variáveis de ambiente o site roda sem contas (tutorial, treino e progresso ficam no aparelho). Para
contas e admin, veja .env.example e docs/supabase.md.
O modo offline (service worker) só liga no build de produção: pnpm build e pnpm --filter @poker/web start.
Estrutura
packages/
poker-engine/ regras puras de Texas Hold'em, avaliador, side pots (com testes)
bots/ bots fácil, médio, difícil e extremo
progressao/ níveis, títulos, regras de XP, catálogo de baralhos (espelhado no SQL)
supabase/
migrations/ tabelas, RLS e funções (convites, perfis, moedas, admin, XP, baralhos)
apps/
web/ Next.js 16 (App Router), React 19, Tailwind v4
src/app/ rotas: (site) = página inicial, (acesso) = entrar, convite e primeiro acesso,
(app) = lobby, treino, tutorial, baralhos, progresso, admin
public/sw.js service worker do modo offline
src/components/ seções, ilustrações (mesa, cartas, avatar), formulários
src/lib/ validação (zod) e utilitários, com testes
docs/
requirements.md consolidação do que entra ou não no jogo, conflitos e sugestões
architecture.md decisões de arquitetura (ADRs)
supabase.md como ligar o banco e criar a conta de dono
progresso-e-sincronizacao.md regras de XP, níveis e sincronização
briefing/ documentos originais do projeto
Regras que não mudam
- Fichas, prêmios e moeda cosmética são 100% virtuais. Não existe pagamento.
- O servidor é a autoridade das partidas; o cliente só envia intenções.
- Cartas fechadas nunca saem do servidor para quem não é dono delas.
- A chave secreta do Supabase só existe no servidor de jogo.
Dica: se o projeto estiver dentro do OneDrive, a sincronização do node_modules deixa tudo lento.
Prefira uma pasta fora do OneDrive (ex.: C:\dev\poker).
