🔥 Funcionalidades

• Em breve...

✨ Tecnologias

• Flutter
• Dart
• Firebase
• JSON
• Git
• GitHub
• GitHub Actions

🎨 Layout do Projeto

• Em breve...

🧱 Arquitetura do Projeto

• A arquitetura proposta para esse projeto é baseado no Flutter Architecture Guide, mas não será implementado todos os conceitos apresentados nesse guia.

📄 Documentação das API's

• PokéAPI
• API YouTube Data Guide
• API YouTube Data Docs

⚠️ Commits Semântico

A primeira e principal descrição de um commit semântico, refere-se a seu tipo, os quais possuem a finalidade de comunicar a intenção de processamento que o utilizador teve em sua execução.

Abaixo será enumerado os principais types descritos na documentação do Angular Commit Message Guidelines:

1. ⚠️ build: Alterações que afetam o sistema de construção ou dependências externas (escopos de exemplo: gulp, broccoli, npm);
2. ⚠️ ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs);
3. ⚠️ docs: Referem-se a inclusão ou alteração somente de arquivos de documentação;
4. ⚠️ feat: Tratam adições de novas funcionalidades ou de quaisquer outras novas implantações ao código;
5. ⚠️ fix: Essencialmente definem o tratamento de correções de bugs;
6. ⚠️ perf: Uma alteração de código que melhora o desempenho;
7. ⚠️ refactor: Tipo utilizado em quaisquer mudanças que sejam executados no código, porém não alterem a funcionalidade final da tarefa impactada;
8. ⚠️ style: Alterações referentes a formatações na apresentação do código que não afetam o significado do código, como por exemplo: espaço em branco, formatação, ponto e vírgula ausente etc.);
9. ⚠️ test: Adicionando testes ausentes ou corrigindo testes existentes nos processos de testes automatizados (TDD);
10. ⚠️ chore: Atualização de tarefas que não ocasionam alteração no código de produção, mas mudanças de ferramentas, mudanças de configuração e bibliotecas que realmente não entram em produção;
11. ⚠️ env: Basicamente utilizado na descrição de modificações ou adições em arquivos de configuração em processos e métodos de integração contínua (CI), como parâmetros em arquivos de configuração de containers;
12. ⚠️ improvement: Melhorias em uma implementação atual sem adicionar um novo recurso ou consertar um bug.

Observe que esses tipos não são obrigatórios pela especificação do Conventional Commits.

Reforço que estes são os principais tipos utilizados, mas existem outros diversos que podem ser empregados e também serem adequados a necessidade de sua equipe de desenvolvimento.

Nesse projeto serão utilizados os tipos acima definidos.

🧠 Aprendizados

O que você aprendeu construindo esse projeto? Quais desafios você enfrentou e como você superou-os?

💻 Melhorias

Que melhorias você fez no seu código? Ex: refatorações, melhorias de performance, acessibilidade, etc

🎯 Roadmap

• ☑️ v1.0.0 -> MVP
  • Pokédex com tela de listagem de pokémons e tela de detalhes sobre o pokémon
• ☑️ v1.1.0 -> Features Pokémons Favoritos e Times
  • Funcionalidades para a Pokédex poder favoritar um pokémon e montar um time com os pokémons favoritados (mostrando dados referentes a cobertura de tipos, forças, fraquezas e resistências)
• ☑️ v1.2.0 -> Feature Selecionar Golpes
  • Funcionalidade para a Pokédex permitir o usuário escolher os golpes de cada pokémon favoritado

ℹ️ Variáveis de Ambiente

Em breve...

🚀 Como executar o projeto

Para clonar e executar esta aplicação, você irá precisar do Git, Flutter v3.27.0 ou maior e Dart v3.6.0 ou maior instalado no seu computador.

Para os comandos no terminal:

Clonar este repositorio

  git clone https://github.com/edusantsales/pokehub.git

Acessar o diretório do projeto em seu computador

  cd pokehub

Instalar as dependencias do projeto

  flutter pub get

Verificar a instalação do Flutter em seu computador

  flutter doctor

Executar o app no iOS Simulator / Android Emulator / Chrome ou no seu dispositivo conectado ao computador

  flutter run

🚀 Como executar os testes

Para rodar os testes, rode o seguinte comando dentro do diretório do projeto

  flutter test

📱 Como instalar no dispositivo iOS ou Android

Em breve...

📝 Autores

• @edusantsales

✅ Siga-me

Copyright © 2025 @edusantsales. Todos os direitos reservados.