The FT server application is for achieve world news headlines that client can access the news that contains the keyword by searching for a specific keyword. like the Brexit, so the application shows all the news about Brexit. Also the application has pagination which has the ability to categorize the pages into a specific number that client select.
App Name : FT API news Customer : Financial Times Development Team : Meisam E Zarghani (Backend , frontend developer : 24 Apr 2021 - till date) Date : 30 Apr 2021 Server URL : [https://ft-server-side-meisam.herokuapp.com/]
The purpose of this file is to provide overview, setup instructions and background information of the project. If you have joined this project as a part of the development team, please ensure this file is up to date.
Note : Any dependencies added / modified to this project which affect the running of the code in this git repository must be listed in this file. All developers must ensure that the instructions mentioned in this file are sufficient to enable a new developer to obtain a executable copy of the latest code in this repository, without involvement from any other human assistance.
I) language requirements :
- NodeJS
- CSS II) Tools
- VScode
- Postman
- heroku
- GitHub
- This project is a server based project which uses NodeJS for the backend side and uses specific API from Financial Times.
- Express Handlebars for send the final data to the client side also use that Handlebars for Pagination.
- The code is store on Github Repository and the server application is running on Heroku.
- The design for reference is from FT.com website.
- The application can work without the javaScript language on you browser.
- Express
- Handlebars
- Helper
- node-fetch
- routes
- body-parser
- Pagination
As mentioned earlier , this is a NodeJS project, The below mentioned steps may vary significantly across various operating systems, please follow them accordingly. These instructions are aimed at a developer who has been added to the project team, after the project development has already been initiated, Therefore the aim is to get the code from the git repository to run on the developer's system, so as to allow him / her to continue with further development.
gh repo clone Erwin6997/FT_Server-Side-Rendering [https://github.com/Erwin6997/FT_Server-Side-Rendering]
cd FT_Server-Side-Rendering
As of writing this guide the main branch used for development is : develop To switch to this branch : git checkout develop
This project requires NodeJS for running, You can install it by referring to the official NodeJS page : [https://nodejs.org/en/] The NodeJS version used at the time of writing this file is : v14.16.1 You can check the installed version using Node -v The package.json file contains the list of all npm plugins and libraries used for this project. Please ensure this file is updated incase any plugin is added / removed. Please follow below steps for installation : Install NodeJS and Dependencies
Next reload the package.json
The .evn file has fore variables which the server need them to run such as:
- PORT for port the app used,
- FT_KEY for the Key which the app need for get access to the API,
- FT_URL for Financial Times API url,
- CONTENT_TYPE for FT content type for API.
For have this file you can connect with developer team with this email [zarghani.m@gmail.com].
nodemon server.js (If you get error about Access to this API has been disallowed means you Token Key which you need for get access to the FT API is expired ) NPM Start