Skip to content

katozaaaa/weatherApp

Repository files navigation

🌤 weatherApp

Live Demo Backend Repo

A responsive weather application built with React and TypeScript that provides current and forecasted weather data based on user location or search input.

image

✨ Key Features

  • 🌍 Automatic location detection
  • 🔍 Manual city search
  • 📈 Detailed weather forecasts
  • 📱 Mobile-friendly design

🛠 Tech Stack

React TypeScript SASS Vite Axios React Query Fetch API

🌍 API Integration

The app uses the following third-party APIs to deliver weather data and location services:

Weather Data

OpenWeatherMap

  • Provides current weather and forecasts
  • Returns temperature, humidity, wind speed, and weather conditions
  • Free tier available with API key

Location Services

GeoNames

  • Converts city names to geographic coordinates
  • Supports autocomplete for location search
  • Free tier available with username registration

ipapi.co

  • Detects user location by IP address
  • Returns city, country, and coordinates
  • Free tier available (1000 requests/day)

🚀 Quick Start

Prerequisites

  • Node.js v20.11.1
  • Backend server running

1. Clone the repository:

git clone https://github.com/katozaaaa/weatherApp.git

2. Go to the project folder:

cd weatherApp

3. Install dependencies:

npm install

4. Start the development server:

npm run dev

🛠 Available Commands

Command Description
npm run dev Start development server
npm run build Create production build
npm run lint Run ESLint
npm run lint:fix Auto-fix linting errors
npm run preview Preview production build

About

Project website with weather forecast

Resources

Stars

Watchers

Forks

Contributors