free-programming-books-search/README.md

free-programming-books-search

The free-programming-books-search is a companion project of free-programming-books. It allows users to search by book title or author and filter by language.

Contents

• Installation
• Deployment

Installation

NPM Installation

1. Make sure you have Node.js installed. If you already do, skip to Running the Website
2. Otherwise, download the LTS installer from Node.js website.
3. Follow the instructions of the installer, make sure npm is listed as a package to be installed.
4. Click Install.
5. Verify that Node.Js has been installed by going to command line and typing in node. It should show the current version.
6. Close out of Node by either closing and reopening the command line or with Ctrl + C.
7. Make sure to check out the NPM website for more info.

Running the Website

1. Make sure you have Git installed.
2. Clone the repo from Github with Git.
3. Navigate to the folder using command line. (easy way is to type "cd" and then drag and drop the folder into command line)
4. Type npm install -g
5. Type npm install react-scripts
6. Type npm start. At this point, the commnand prompt should start up the server, and a tab in your default browser should open up to localhost.

Deployment

MAKE SURE YOU HAVE COMPLETED THE INSTALLATION STEPS FIRST!

1. First, make sure that you the local folder containing the files has a remote configured called "origin".
   1. If you aren't sure, navigate to the folder using Git (type "cd", then drag and drop folder in to Git command line.).
   2. Type git init
   3. Type git remote add origin <repo url>,replacing with the url of your github repository.
2. Now, run 'npm install -g gh-pages'.
3. Run npm run deploy.
4. This should deploy your code to "https:.github.io/free-programming-books-search/"