In this project you’ll be building a react/redux weather app that allows you to see different forecast information for a given city, and set favorite cities to pin to the home page, and work in some cool UX/UI functionality based on sunrise/sunset.
- Retrieve and display sunrise and sunset information from the Sunrise-Sunset API
- Use the Geolocation API to determine your current location
- Retrieve and display forecast data from the OpenWeatherMap API or WeatherUnderground API
- Save “pinned” or favorite cities to display their extended weather forecasts
Obtain an API Key
To get sunrise/sunset information use this api.
To get extended weather, you’ll need to sign up for an API key. There are lots of weather APIs out there, the two that work best for this project are either OpenWeatherMap API, or WeatherUnderground API. Do some reseach and pick your favorite.
Webpack and react dependencies have been setup for you in the weather-app repo. Fork this repo and follow the setup instructions in the README. You’ll notice that the repo has been created using the
Note: The repo has a few additional things set up for you out of the box. This does not mean you can’t make changes to how the app is structured, but there are some pieces that might look unfamiliar. These include (but are not limited to) the
You are STRONGLY ENCOURAGED to do a research spike on these elements before diving into coding this project. We are fully aware that you haven’t worked with some of these concepts before, but the ultimate goal of this project is to emphasize heavy use of documentation and to encourage a ‘divide and conquer’ mentality among your group members.
localStorage to persist data.
Iteration 0: Current Location
- Use the Geolocation API to determine your current location.
- You may be prompted by your browser to grant access to your location. This request can take some time, and it might not be 100% accurate, but it should provide you with enough information to get the weather forecast using the choices listed above.
Iteration 1: Sunrise & Sunset
- At the top of the app you should display the sunrise and sunset information with icons.
- Based on that information, and the current time, your UX should change to indicate whether it is morning, noon, evening, or night.
Iteration 2: Current Weather Header
- Create a header bar that displays your current city’s temperature (in Fahrenheit) and weather description (e.g. ‘windy’, ‘rainy’, ‘sunny’)
Iteration 3: Settings Page
- Create a
/settingsroute that displays an input field to enter a city’s zip code and save it as a “pinned” city. User should be able to delete cities.
Iteration 4: Pinned Cities Dashboard
- Create a dashboard/index page that shows the Current Weather for a maximum of 3 “pinned” cities. If there aren’t 3 pinned cities, add a placeholder with a link to “Pin a new city”
Iteration 5; Pinned City Show Page
- Each pinned city forecast on the dashboard should include a link to display an extended 5 day/3 hour forecast. The route for the extended forecast should be something like
Implement React Router 4.0
NOTE: Wireframes are general guidelines. Besides the requirements specified above, feel free to get creative and create a kick ass, clean, unique user experience.
Extended Forecast Page
- 4: The application meets all of the requirements listed above and implements one or more of the extensions.
- 3: The application consists of one page with all of the major functionality being provided by React. No approach was taken that is counter to the spirit of the project and its learning goals. There are no features missing from above that make the application feel incomplete or hard to use.
- 2: The application is in a usable state, but is missing 1 or more of the features outlined in the specification above.
- 1: The application is missing 3 or more smaller features or 1 major feature essential to having a complete application.
- 0: The application is unusable.
- 4: Appropriate components are wrapped in connected Redux container components. The Redux store contains all necessary application data and nothing more. All state changes are handled through Redux actions and reducers.
- 3: At least one component is not connected with Redux appropriately. Application state is mutated by more than just Redux. The Redux store is missing application data that it should be handling.
- 2: Application state is mostly outside the control of Redux. Application did not make use of Redux actions and reducers to mutate state. Components do not demonstrate a clear understanding of stateful vs. statelessness.
- 1: Application does not make use of Redux to manage state. There are little or no connected components.
- 4: Application is a single page and uses the React Router to display appropriate components based on URL.
- 3: Application is a single page and uses the React Router but does not display the appropriate components upon navigating.
- 2: Application does not render/cannot find additional routes.
- 1: Application did not use a Router
- 4: Application has exceptionally well-factored code with little or no duplication and all components separated out into logical components. There are zero instances where an instructor would recommend taking a different approach.
- 3: Application is thoughtfully put together with some duplication and no major bugs. Group can speak to choices made in the code and knows what every line of code is doing.
- 2: Application has some duplication and minor bugs. Developer can speak to most choices made in the code and knows what every line is doing.
- 1: Application has a significant amount of duplication and one or more major bugs. Group cannot speak to most choices and does not know what every line of code is doing.
- 4: Project has a running test suite that exercises the application using Enzyme. The test suite covers almost all aspects of the application including the Redux actions and reducers.
- 3: Project has a running test suite that tests multiple levels but fails to cover some features.
- 2: Project has sporadic use of tests at multiple levels. The application contains numerous holes in testing and/or many features are untested.
- 1: There is little or no evidence of testing in this application.
- 4: The group effectively uses different Git branches, submits pull requests and reviews each other’s code. The evolution of the application and who was responsible for what features is clearly documented through github.
- 3: The group makes a series of small, atomic commits that document the evolution of their application and it is clear who was responsible for what features.
- 2: The group makes large commits covering multiple features that make it difficult for the evaluator to determine the evolution of the application and who worked on what features.
- 1: The group committed the code to version control in only a few commits. The evaluator cannot determine the evolution of the application.
- 0: The application was not checked into version control.