🌍 Descubra Portugal: O Quiz

📖 Descrição

Descubra Portugal: O Quiz é uma aplicação interativa que desafia os usuários com perguntas sobre geografia, história e curiosidades de Portugal. Teste seus conhecimentos e descubra mais sobre este belo país!

💡 Motivação

A motivação por trás do 'Descubra Portugal: O Quiz' foi a combinação de aplicar conceitos técnicos e criar um portfólio interessante, enquanto aprendo sobre Portugal, o país onde planejo buscar oportunidades de emprego e me tornar cidadão. Juntei o útil ao agradável, e foi uma experiência incrível explorar mais sobre essa bela nação.

✅ Funcionalidades

• 📋 Coleta o nome do usuário para personalizar a experiência.
• ✔️ Exibe a quantidade de perguntas corretas no final do quiz.
• 🎉 Indica o acerto ou erro de cada resposta com emojis.
• 📊 Proporciona uma experiência simples e interativa, demonstrando conceitos diversos de um quiz de perguntas e respostas, incluindo sistema de pontuação.

🛠️ Tecnologias Utilizadas

• Node.js: 🟢 Ambiente de execução para o JavaScript no servidor.
• React: ⚛️ Biblioteca JavaScript para construir interfaces de usuário.
• Next.js: ⚡ Framework para React que permite renderização do lado do servidor.
• JavaScript: ✨ Linguagem de programação utilizada para a lógica do projeto.
• TypeScript: 📝 Superconjunto do JavaScript que adiciona tipagem estática.
• HTML5: 📄 Estrutura da aplicação.
• CSS3: 🎨 Estilo da aplicação.
• Figma: 📐 Ferramenta utilizada para o desenvolvimento do layout, aplicando conceitos de UI/UX.
• Bibliotecas do React e Next.js: 📚 Para funcionalidades adicionais e melhor experiência do usuário.

🚀 Como Executar

1. Certifique-se de que o Node.js (na versão LTS) e o npm estão instalados na sua máquina.

2. Clone o repositório do projeto:

   git clone https://github.com/devCarlosHenSil/Quiz.git
   

3. Navegue até o diretório do projeto:

   cd Quiz
   

4. E execute o projeto:

   npm run dev
   

O comando npm run dev instalará automaticamente as dependências do projeto.

5. Acesse a aplicação no seu navegador, preferencialmente em:

   http://127.0.0.1:3000
   

🤝 Como Contribuir

Contribuições são bem-vindas! Para colaborar com o projeto, acesse a documentação e siga os passos:

Agradecemos por contribuir e ajudar a melhorar o projeto!

📜 Licença

Este projeto está licenciado sob a MIT License. Isso significa que você é livre para usar, modificar e redistribuir o código, desde que qualquer trabalho derivado também seja licenciado sob a mesma. Para mais detalhes, consulte o arquivo LICENSE neste repositório.

🔜 Próximos Passos

• 🔄 Converter o conteúdo do global.css em componentes.
• 📝 Exibir o nome do usuário definido na tela anterior na tela de resultados.
• 🛠️ Quebrar o onSubmit em funções menores para melhor organização do código.
• 📱 Criar um componente genérico que represente a tela.
• 📊 Desenvolver a tela de resultados para exibir o desempenho do usuário.
• ⏩ Implementar a funcionalidade de seleção de alternativas ao apertar ENTER ou Espaço.
• 🔧 Continuar a evolução do projeto com novos aprimoramentos e funcionalidades.

🖼️ Capturas de Tela

Tela Inicial

Tela de Perguntas

Na tela de perguntas, um emoji é exibido ao lado da pergunta para indicar se a resposta foi correta ou incorreta.

Tela de Resultados

📫 Contato

Se você tiver alguma dúvida ou sugestão, fique à vontade para entrar em contato:

• E-mail: sh.carlos.henrique@gmail.com
• LinkedIn: Carlos Henrique Silva
• GitHub: devCarlosHenSil