efalayi / asedeyhot-news

This is news feed application which provides you with latest, top, and popular news from around the globe.

Home Page:https://asedeyhot-news.herokuapp.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status Coverage Status Code Climate

AsEDeyHot

This news feed application gathers latest, popular, and top headlines from around the globe. It consumes the NewsAPI which provides at least 60 news sources - including CNN,BBC, and TechCrunch.

App Features
  • A user can view sources from at least 60 news sites from around the globe
  • A user can view articles from a particular news source(e.g BBC News)
  • A user can sort headlines and view them (depending on the available sort parameters for that particular news source)
  • A user can favourite a news source or article. This functionality can only be accessed when the user is signed in with a google plus account.

Technology

This application was developed purely with JavaScript using React and the Flux Architecture, NodeJs, and Express.

Dependencies

Getting Started

  • Clone the project from repository github.com/andela-efalayi/asedeyhot-news
  • In your terminal, cd into the cloned folder and run npm install. This installs all the app's dependencies.
  • Run npm start in your terminal, open your browser, and type localhost:3000. This runs the application on your local machine.
  • Alternatively, you can access the app on asedeyhot-news.herokuapp.com

How to Contribute

I welcome any form of contribution. If you feel something can be done better or there's an issue that needs to be fixed or you are just interested in a specific part of the project, but not sure where to begin, feel free to ask. On the other hand if the contribution you wish to make has not been documented in an existing issue, please create new issue before submitting your pull request.

Limitations

- Presently, this news app can not share articles/headlines.
- News articles cannot viewed directly on the app.

Testing

All app components, actions, and stores were tested using Facebook's Jest The test files can be found in the tests folder.

  • To run the tests, run npm test on the command line. This automatically runs jest on all test files.
  • You can also run jest directly. However, jest-cli needs to be globally installed on your machine.

License

MIT © 2017 | Esther Falayi | Andela, Nigeria

About

This is news feed application which provides you with latest, top, and popular news from around the globe.

https://asedeyhot-news.herokuapp.com/

License:MIT License


Languages

Language:JavaScript 90.3%Language:CSS 7.4%Language:HTML 2.3%