Skip to content

Eliseubartolomeu/previsao-tempo

Repository files navigation

🌦️ ElisTime — Previsão do Tempo

Este é um projeto de previsão do tempo desenvolvido em React, Focado na consulta de previsões meteorológicas em tempo real, com integração a uma API externa. O projeto oferece funcionalidades como pesquisa por cidade, exibição das condições climáticas atuais, previsão estendida para 5 dias e informações detalhadas de temperatura, umidade, vento, além dos horários de nascer e pôr do sol.

📸 Capturas de Tela

Tela de Boas-vindas

Veja como os usuários são recebidos ao acessar a aplicação:

Tela de Boas-vindas


🌤️ Página Principal - ElisTime

Exibe informações climáticas detalhadas para a cidade pesquisada:

Página Time


📱 Versão Mobile

A aplicação também é totalmente responsiva para dispositivos móveis:

Tela de Boas-vindas Página Principal
Boas-vindas Mobile Time Mobile

📜 Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para mais detalhes.

✨ Funcionalidades

  • 🔍 Consulta de previsão do tempo por cidade.
  • 🌡️ Exibição de temperatura, umidade, velocidade do vento e condições climáticas.
  • 🧭 Horário do nascer e pôr do sol.
  • 📅 Previsão dos próximos 5 dias.
  • 📱 Interface moderna, amigável e responsiva.

🛠️ Tecnologias Utilizadas

  • React 19: Biblioteca JavaScript para construção de interfaces modernas.
  • React Router DOM 7: Para navegação entre páginas de forma declarativa.
  • React Query (TanStack Query): Gerenciamento eficiente de requisições assíncronas e cache.
  • Axios: Para realizar requisições HTTP à API de clima.
  • Bootstrap 5: Framework CSS para layout responsivo.
  • Bootstrap Icons: Ícones SVG integrados ao Bootstrap.
  • Sass: Pré-processador CSS para estilos mais organizados e reutilizáveis.

✅ Pré-requisitos

Antes de começar, certifique-se de ter as seguintes ferramentas instaladas:

Você também precisará de uma chave de API do OpenWeatherMap para obter os dados meteorológicos.

Crie uma conta, Depois de logado, clique no seu nome de usuário de seguida em My API Keys para obter a sua chave da API.


⚙️ Configuração do Projeto

  1. Clone este repositório:

    git clone https://github.com/Eliseubartolomeu/previsao-tempo.git

2. Acesse o diretório do projeto:
 ```bash
 cd previsao-tempo
  1. Instale as dependências:

    npm install
    # ou
    yarn install
  2. Você vai precisar de um arquivo .env na raíz do projecto irás encontrar um arquivo chamado .env-example renomeio-o para .env e adicione sua chave de API no valor da váriavel:

    VITE_OPENWEATHER_API_KEY=escrevaAquisuaChavedeAPI
    

Executando o Projeto

Para iniciar o servidor de desenvolvimento, execute:

npm run
# ou
yarn start

O aplicativo estará disponível em http://localhost:5173/.

Contribuindo

Contribuições são bem-vindas! Siga os passos abaixo para contribuir:

  1. Faça um fork do projeto.

  2. Crie uma branch para sua feature ou correção:

    git checkout -b minha-feature
  3. Faça commit das suas alterações:

    git commit -m "Descrição da minha feature"
  4. Envie para o repositório remoto:

    git push origin minha-feature
  5. Abra um Pull Request.

Considerações

Não se esqueça de deixa um star ⭐ no repositório e me seguir 😅

Estamos juntos...

About

Aplicação de previsão do tempo em tempo real. Desenvolvida em React + Typescript

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published