Repolode
Enviar
Ralex91

Ralex91/Razzia

Uma plataforma de quiz open source e auto-hospedada para organizar jogos ao vivo em eventos menores, com implantação via Docker.

Alternativa open source a:Kahoot

Ver no GitHubSite
Estrelas
1,102
Forks
71
Issues abertas
31
Último commit
há 5 dias

O que é?

Razzia é uma plataforma de quiz que você hospeda no próprio servidor, voltada a eventos menores. Uma interface de gerenciamento permite que o anfitrião crie uma partida, compartilhe um código da sala com os participantes e inicie a sessão quando todos entrarem. Os participantes acessam o jogo pelo navegador, usando a URL da partida, e respondem às perguntas durante a rodada.

Os quizzes e resultados são armazenados em arquivos numa pasta de configuração local, que é preservada durante as atualizações. O projeto pode ser executado com Docker Compose ou Docker, ou instalado diretamente a partir do código-fonte com Node.js 24+ e pnpm. A interface de gerenciamento é protegida por uma senha definida por uma variável de ambiente, e o README explica como executar o app atrás de um proxy reverso, como Traefik, Nginx ou Caddy.

O projeto também publica um protocolo WebSocket e uma API HTTP, permitindo que desenvolvedores criem clientes personalizados, como uma campainha física baseada em ESP32.

Recursos principais

  • 01Organize partidas de quiz ao vivo com uma interface de gerenciamento e códigos de sala para os jogadores.
  • 02Armazene quizzes e resultados em arquivos locais que são preservados durante as atualizações.
  • 03Implante com Docker ou Docker Compose, ou execute a partir do código-fonte com Node.js e pnpm.
  • 04Proteja a interface de gerenciamento com uma senha definida em uma variável de ambiente.
  • 05Execute atrás de proxies reversos comuns, como Traefik, Nginx ou Caddy.
  • 06Crie clientes personalizados usando um protocolo WebSocket e uma API HTTP documentados.

Casos de uso

  • Organizar uma rodada de quiz ou perguntas e respostas em uma reunião de equipe, aula ou festa pequena.
  • Hospedar uma pesquisa ou jogo educativo em um servidor privado.
  • Criar um sistema de campainhas físicas que se conecte ao servidor do quiz por WebSocket.

Início rápido

  1. 1

    Crie um arquivo compose.yml com a definição do serviço Razzia

  2. 2

    Crie um arquivo .env com MANAGER_PASSWORD definido

  3. 3

    Inicie o serviço com o Docker Compose

    docker compose up -d

Antes de usar

  • Para executar sem o Docker, é necessário ter Node.js 24 ou superior e pnpm 10.16 ou superior.

Em coleções

Apps auto-hospedadosFerramentas de aprendizado e educação de código aberto

Tópicos

#quiz#self-hosted#trivia#typescript#websocket#docker#education#game#learning#quizz

Perguntas frequentes

O que é Razzia?
Uma plataforma de quiz open source e auto-hospedada para organizar jogos ao vivo em eventos menores, com implantação via Docker. Razzia é uma plataforma de quiz que você hospeda no próprio servidor, voltada a eventos menores. Uma interface de gerenciamento permite que o anfitrião crie uma partida, compartilhe um código da sala com os participantes e inicie a sessão quando todos entrarem. Os participantes acessam o jogo pelo navegador, usando a URL da partida, e respondem às perguntas durante a rodada.
Razzia é gratuito? Qual é a licença?
Razzia é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Razzia ainda é mantido?
Manutenção ativa. O último commit de Razzia foi em 3 de nov. de 2026.
Para que posso usar Razzia?
Organizar uma rodada de quiz ou perguntas e respostas em uma reunião de equipe, aula ou festa pequena. Hospedar uma pesquisa ou jogo educativo em um servidor privado. Criar um sistema de campainhas físicas que se conecte ao servidor do quiz por WebSocket.
Como instalar Razzia?
Crie um arquivo compose.yml com a definição do serviço Razzia Crie um arquivo .env com MANAGER_PASSWORD definido Inicie o serviço com o Docker Compose: docker compose up -d
Onde consigo Razzia?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Ralex91/Razzia

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

Projetos relacionados