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.
Veja como os usuários são recebidos ao acessar a aplicação:
Exibe informações climáticas detalhadas para a cidade pesquisada:
A aplicação também é totalmente responsiva para dispositivos móveis:
Tela de Boas-vindas | Página Principal |
---|---|
![]() |
![]() |
Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para mais detalhes.
- 🔍 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.
- 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.
Antes de começar, certifique-se de ter as seguintes ferramentas instaladas:
- Node.js (v14 ou superior)
- npm ou yarn
- Um editor de código como o Visual Studio Code
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.
-
Clone este repositório:
git clone https://github.com/Eliseubartolomeu/previsao-tempo.git
2. Acesse o diretório do projeto:
```bash
cd previsao-tempo
-
Instale as dependências:
npm install # ou yarn install
-
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
Para iniciar o servidor de desenvolvimento, execute:
npm run
# ou
yarn start
O aplicativo estará disponível em http://localhost:5173/.
Contribuições são bem-vindas! Siga os passos abaixo para contribuir:
-
Faça um fork do projeto.
-
Crie uma branch para sua feature ou correção:
git checkout -b minha-feature
-
Faça commit das suas alterações:
git commit -m "Descrição da minha feature"
-
Envie para o repositório remoto:
git push origin minha-feature
-
Abra um Pull Request.
Não se esqueça de deixa um star ⭐ no repositório e me seguir 😅
Estamos juntos...