{"id":18416828,"url":"https://github.com/tomtom828/nyt-react","last_synced_at":"2025-04-07T12:32:09.849Z","repository":{"id":137822266,"uuid":"75987878","full_name":"tomtom828/nyt-react","owner":"tomtom828","description":"A Node, Express, MongoDB, and ReactJS application where users can query, display, and save articles from the New York Times Article Search API.","archived":false,"fork":false,"pushed_at":"2016-12-19T04:36:06.000Z","size":4350,"stargazers_count":4,"open_issues_count":1,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-22T18:41:14.155Z","etag":null,"topics":["axios","nodejs","react","webpack"],"latest_commit_sha":null,"homepage":"https://ny-times-react.herokuapp.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tomtom828.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-12-09T00:52:44.000Z","updated_at":"2020-10-25T15:01:17.000Z","dependencies_parsed_at":"2024-01-22T13:10:49.235Z","dependency_job_id":"73601ad6-deb2-4e41-a5ac-b366b10bf44e","html_url":"https://github.com/tomtom828/nyt-react","commit_stats":null,"previous_names":["tomtom828/nyt-react"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomtom828%2Fnyt-react","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomtom828%2Fnyt-react/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomtom828%2Fnyt-react/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomtom828%2Fnyt-react/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomtom828","download_url":"https://codeload.github.com/tomtom828/nyt-react/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247653160,"owners_count":20973775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","nodejs","react","webpack"],"created_at":"2024-11-06T04:07:29.183Z","updated_at":"2025-04-07T12:32:04.839Z","avatar_url":"https://github.com/tomtom828.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# :newspaper: NY Times ReactJS App :statue_of_liberty:\nA `NodeJS`, `MongoDB`, `Express`, and `ReactJS` application where users can query, display, and save articles from the [New York Times Article Search API](http://developer.nytimes.com/). Users can remove saved articles as well.\n\nPlease check out the deployed version in Heroku [here](https://ny-times-react.herokuapp.com/)!\n\nClick on the headlines to be re-directed to the full New York Times articles.\n\n\n## Functionality\nOn the backend, the app uses `express` to serve routes and `mongoose` to interact with a `MongoDB` database.\n\nOn the frontend, the app uses `ReactJS` for rendering components, `axios` for internal/external API calls, and `bootstrap` as a styling framework.\n\nIn order to transpile the JSX code, `webpack` and `babel` were utilized. All of the JSX  code in the `/app` folder was transpiled into the `bundle.js` file located in the `/public` folder.\n\n\n## Cloning down the repo\nIf you wish to clone the app down to your local machine...\n  1. Ensure that you have MongoDB set up on your laptop\n    * An amazing repo to get you started with that can be found [here](https://github.com/dannyvassallo/mongo_lesson).\n  2. Once you are set up, `cd` into this repo and run `npm install`.\n  3. Then open another bash or terminal window and run `mongod`\n  4. Run the script with `node server.js`.\n  5. Navigate to `localhost:3000` in your browser.\n\nNote that if you made changes to the JSX code in the `/app` folder, you must transpile it to see your changes. When `cd`-ed into this repo, enter `npm run bundle` in the command line to trigger my `webpack` script.\n\nThe `/test` folder can be disregarded since its files were made just for laying out the design of the app.\n\n\n## Screenshots\n#### Users are able to submit a topic, start year, and end year to query the New York Times\n![Query Articles](/screenshots/query-articles.png)\n\n#### Press the green, save button and the article is bookmarked via an `/api/saved` post route\n![Article Content](/screenshots/add-bookmark.png)\n\n#### Press the red, remove button and the bookmarked article is removed via an `/api/delete/:id` post route\n![Add Comment](/screenshots/remove-bookmark.png)\n\n#### Note that the get routes include an **internal route** to `/api/saved` for querying and displaying all the bookmarked articles from the Mongo database.\n\n#### Note that the get routes also include an **external route** to `https://api.nytimes.com/svc/search/v2/articlesearch.json` for querying the New York Times.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomtom828%2Fnyt-react","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomtom828%2Fnyt-react","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomtom828%2Fnyt-react/lists"}