hpenacho / solaris-weather-app Goto Github PK

Key Features • Resources & Libraries Used • How to use • You may also like • License

This project was conceived and developed with the intention of enhancing my portfolio and putting into practice everything I've learned during University of Helsinki's FullStackOpen course.

• Fetch the current weather forecast for any location

  • An autocomplete feature tries to guess your search as you type and offers suggestions.
  • Suggestions have a country indicator, to help differentiate locations with equal names, such as Paris from France, or Paris from the US.
  • This project makes use of the navigator.geolocation property whenever the user requests and allows their location to be tracked so they may know the weather in their immediate vicinity.

• Customizable experience

  • The user may choose between two styles of icons, animated and static.
  • The user is able to pick the timeframe of the hourly forecast, between intervals of 1h, 3h and 6h.
  • Celcius and Fahrenheit are toggleable choices when it comes to unit type.
  • Light and dark mode are also customizable and affect the look of the whole application, the initial theme is based on the users system theme.
  • All of the above are saved to the browsers local storage and retrieved when available such that future uses of the application remember the users preferences.

• Extensive Forecast Details

  • Both the hourly and daily forecast items can be clicked for further information, a plethora of subitems are displayed, such as temperature data, chance of rain, UV rays, cloud coverage, visibility, humidity, wind direction and speed, etc.
  • The items shown are conditionally rendered based on their relevance, UV rays wont be shown during nightly forecasts on the hourly, rain information will be omitted during clear sky days with zero chance of precipitation, etc.

• Wikipedia and Googlemaps links

  • Links are provided for the location queried by the user.

• High responsiveness

  • Special care was taken to ensure a pleasant experience on smaller viewports, with certain components being exclusive to this scenario, such as an extensible drawer list, collapsible settings cogwheel, etc.

• This project makes use of the following:

  • Meteorological data is fetched from OpenWeather, specifically I make use of the One Call API to gather the bulk of my weather forecast for a particular location.
  • The Geo Coding API is used to derive weatherdata from an aproximation of the user's location whenever geo-location is requested.
  • In terms of external libraries, the foundation of the project was built using Create-React-App, although I plan to transition to Next.js for future projects.
  • MaterialUI 5 for the UI
  • Axios for API requests
  • React-elastic-carousel for the carousel component
  • notistack for stackable and customizable notifications.

Use npm to install all the dependancies:

npm install

Grab a free API key from Open Weather and paste it on a .env at the root of your directory, like so:

npm start

• SimpleCalculator-Java - A simple calculator built using Java.
• MusicPlayer-Java - A flexible music player built in Java.

MIT