InstaWeather is a Next.js based weather application designed to deliver precise and user-friendly weather updates. It's tailored for users who seek a quick glance at the current weather conditions along with detailed forecasts.
-
Current Temperature & Summary: Displays the current temperature along with a short summary of the current weather conditions.
-
Today's Highs & Lows: Shows the maximum and minimum temperatures for the day.
-
Today's Forecast Summary: Provides a text summary of the weather forecast for the day.
-
Date Display: Shows today's date for easy reference.
-
Celsius/Fahrenheit Toggle: Users can switch between Celsius and Fahrenheit temperature units with a convenient toggle button.
-
Hourly Forecast: Displays the weather forecast for the upcoming 24 hours, updated hourly.
-
14-Day Forecast: Offers a 14-day weather forecast, including today, with the day and expected high temperatures (e.g., TUE, 85°F).
-
City Name Display: Shows the name of the city (e.g., New Cairo) based on the user's location.
-
Geolocation Support: Utilizes the browser's Geolocation API to accurately locate the user for localized weather updates. Users will be prompted by the browser to allow location access for the app to function correctly.
To get started with InstaWeather:
-
Fork or Clone the Repository:
git clone https://github.com/youssefwt/insta-weather.git
-
Install Dependencies:
Inside the cloned directory, run:
npm install
-
Add env.local file in root folder:
NEXT_PUBLIC_API_KEY=API-KEY
-
Run the Application:
Start the development server:
npm run dev
The application will be available at
http://localhost:3000
. -
Location Access:
On the first run, your browser will ask for location permissions. Please allow this to enable accurate weather updates.
-
Enjoy the Weather Updates!
Contributions to InstaWeather are always welcome, whether it be improvements to the documentation or new functionalities. Please feel free to fork the repository and submit pull requests.
InstaWeather is released under the MIT License.
For any queries or suggestions, please open an issue on the GitHub repository or contact the maintainers directly.
InstaWeather: Your go-to weather app for up-to-date and precise weather information!