/nyt-reader

New York Times article filtering app

Primary LanguageJavaScript

NYT Article Reader

Deployed Site

An application to retrieve, filter, and display the New York Times "Top Stories" by section.

Features

  • Thorough project-planning using a GitHub Project Board as well as wireframes and a component-tree, illustrated in advance.
  • Modular React component structure with thorough error-handling and conditional rendering.
  • Dynamic page-routing and URL-setting using Router.
  • Dynaming, RESTful data fetching from the NYT Top Stories API.
  • A custom-built dataset of all NYT "sections" used to populate the dropdown menu, allowing a user to select a specific section and trigger an API fetch using the corresponding API path.
  • Fetched API data is then used to populate the local state using Hooks, which then generates the appropriate number of HTML "story cards" and renders a flex list of articles on the page.
  • All listed articles link to a separate "article details" page, which provides the user with additional info such as the headline, byline, abstract, date published, date updated, photo, and link to the online NYT article, as well as a "topic box" containing a collection of subjects and locations relevant to the article.
  • Intuitive and accessible UX design.
  • Attractive and responsive UI design.

Project Requirements & Goals

  • A strong understanding of React JS and Front-End best practices.
  • Your ability to prioritize for MVP.
  • An understanding of basic usability practices and standards.
  • A clear hierarchy of information.
  • Clean, well thought out code.

Installation

To view the application on your local device:

  1. Clone down this repository
  2. Navigate into cloned repository
  3. Enter npm i in your terminal to install project dependecies
  4. Enter npm start in your terminal to launch server
  5. Once server is initialized, page can be viewed in your browser at http://localhost:3000/

Technologies

JavaScript React Router Hooks HTML CSS Sass
JavaScript React Router react hooks HTML CSS Sass

Developer

Peter Muellerleile GH
P. Muellerleile