Pronto para compartilhar conhecimento

Publicar e compartilhar

Instruções para visualizar este site educativo, baixar os arquivos completos e publicar gratuitamente, sem servidor, login de visitantes ou banco de dados.

1. Visualize e baixe o projeto

O site já pode ser usado na área de prévia do editor. Abaixo está o endereço desta execução; se ela estiver em uma prévia privada, esse não é o link definitivo para os visitantes.

Endereço atual desta execução

Inclui código React + TypeScript, estilos, questões, testes, README e configuração de publicação. Não inclui node_modules nem arquivos compilados.

2. Rode no seu computador

Descompacte o ZIP, instale uma versão LTS do Node.js com npm e abra o terminal na pasta do projeto. Execute:

npm install
npm run dev

Abra o endereço mostrado pelo terminal. Para verificar os testes e gerar a versão publicável:

npm test
npm run build
npm run preview

A versão compilada fica em dist/. Não abra o index.html do código-fonte diretamente: este projeto precisa do Vite.

3. Publique gratuitamente com GitHub Pages

Opção recomendada para este projeto escolar estático. O GitHub Free oferece Pages para repositórios públicos; a pessoa que publica precisa de uma conta, mas os visitantes não precisam.

Crie um repositório público no GitHub, na branch main.
Envie todos os arquivos descompactados para a raiz do repositório, incluindo a pasta oculta .github/workflows/pages.yml. Se o envio pelo navegador omitir arquivos ocultos, use Git ou crie esse arquivo no GitHub copiando o conteúdo do ZIP.
No repositório, abra Settings → Pages → Build and deployment → Source e selecione GitHub Actions.
Abra Actions → Publicar site educativo → Run workflow, escolha main e confirme. O fluxo também roda a cada novo envio para main.
Aguarde os testes e a publicação terminarem. Em Settings → Pages, abra e copie o endereço público exibido.
Teste em outro celular, sem estar conectado à sua conta. Use esse endereço para compartilhar e gerar o QR code.

Limites e cuidados

O código ficará público. A documentação informa até 1 GB para o site publicado, limite flexível de 100 GB de tráfego por mês e limite de tempo de 10 minutos para a implantação. Confira os termos atuais antes do evento. Este site não usa pagamentos, dados pessoais ou serviços de banco de dados.

Documentação oficial e limites do GitHub Pages Como publicar com um fluxo personalizado

Verificação antes da feira

Este botão executa a lógica real dos três jogos: quantidade de questões, alternativas, respostas corretas, partidas com acertos, erros e respostas alternadas, bloqueio de resposta duplicada, avanço e reinício. Não substitui os testes manuais nos aparelhos.

Passou — Quiz cultural: conteúdo completo
10 questões, 4 alternativas por questão e explicações.
Passou — Quiz cultural: todos os acertos
Pontuação 10/10; esperado 10. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Quiz cultural: todos os erros
Pontuação 0/10; esperado 0. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Quiz cultural: respostas alternadas
Pontuação 5/10; esperado 5. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Quiz cultural: reinício
Partida reiniciada na primeira questão e com zero pontos.
Passou — Mito ou fato: conteúdo completo
10 questões, 2 alternativas por questão e explicações.
Passou — Mito ou fato: todos os acertos
Pontuação 10/10; esperado 10. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Mito ou fato: todos os erros
Pontuação 0/10; esperado 0. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Mito ou fato: respostas alternadas
Pontuação 5/10; esperado 5. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Mito ou fato: reinício
Partida reiniciada na primeira questão e com zero pontos.
Passou — Analise a situação: conteúdo completo
6 questões, 3 alternativas por questão e explicações.
Passou — Analise a situação: todos os acertos
Pontuação 6/6; esperado 6. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Analise a situação: todos os erros
Pontuação 0/6; esperado 0. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Analise a situação: respostas alternadas
Pontuação 3/6; esperado 3. Respostas duplicadas e avanço sem resposta bloqueados.
Passou — Analise a situação: reinício
Partida reiniciada na primeira questão e com zero pontos.

Checklist nos aparelhos da feira

Abra a página em Android, iPhone, tablet e computador, em modo retrato e paisagem.
Use Tab, Shift+Tab, Enter e Espaço; confira o foco visível e o diálogo de reinício (Escape fecha).
Conclua os três jogos, confira os pontos e revise as explicações. Recomece e verifique que a pontuação volta a zero.
Confirme que a navegação inferior não encobre conteúdo e que não há rolagem horizontal em telas pequenas.
Leia o QR impresso com a câmera e confirme o endereço público sem login.

Ainda depende de você: publicar na sua conta, confirmar o endereço definitivo e testar o QR impresso nos aparelhos da feira. O site funciona sem add-ons. As respostas não são persistidas; apenas a preferência de tema pode ser lembrada neste dispositivo.