UberPOOL and LyftLine are very efficient and affordable for travelling short distances. However, for suburban areas and a majority of metropolitan cities this option is not available. This is mainly due to low number of people travelling on the same route. The connectivity and frequency of public transportation is limited in these areas. In addition to these issues, there are a lot of difficulties to communicate and plan the rides using social media platforms such as Facebook and Whatsapp. To tackle the problems mentioned above, we have devised WolfPool as a service that specifically targets to enhance communication and convenience in planning of rides.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
What things you need to install the software and how to install them. This software/system works best with Linux/MacOS. The only difference with Windows based systems is the steps involved in installation might be a bit different.
Node.js MongoDB Basic text editor like Atom, Notepad++ or even VIM/EMACS if you are into those :P
This is a step by step series about how to get a development env running
STEP 1: Download and install Node.js from here. Once you complete the installation open a terminal window (Command Prompt for windows) and type the command 'node'. If you have successfully installed you will see a prompt like this.
STEP 2: Download and install MongoDB from here and install it like any other software package. Once you are done with the installation, open a terminal and type the command 'mongo'. If you have successfully installed you will see a prompt like this.
STEP 3: [Optional] If you are the kinda guy who doest not like to manage a database using a terminal or command prompt you can install Studio 3T
STEP 4: Clone the repository in appropriate directory and change the current working directory to 'wolfpool' (the repository folder)
git clone https://github.com/CJ8664/wolfpool.git
cd wolfpool
STEP 5: [NOTE: Please be patient] Now we have to install all the dependencies that are mentioned in the package.json file. If you are not sure what a package.json file please check this url. Understanding this is important because unless all the dependencies mentioned in this are resolved the web application will not start.
Command to install the dependencies [Works both on a terminal or cmd prompt]
npm install --save
STEP 6: With this the basic website is setup, ironically nothing will work because of the two APIs (Google Maps API and Mailjet API) and other code changes.
-
Google Maps API - Please setup a Google Cloud account and get an API key following the neat documentation provided here. Replace this key in the file views/partials/head.handlebars, line 17. This should enable Google Maps and its functionalities on localhost for development and debugging.
NOTE: Once you deploy the app on any online platform, please restrict the access to the Google services by limiting key access, more information here
-
Mailjet - This is a third party service that allows us to send emails, which is used heavily in this application. Please create an account from this site. Once the account is verified you can get the keys from this page. Export or set the environment variables for the API. For windows follow (this)[https://superuser.com/questions/79612/setting-and-getting-windows-environment-variables-from-the-command-prompt], for linux/MacOS run the bellow commands before running STEP 5.
export MJ_PUBLIC_KEY="Your Public key"
export MJ_PRIVATE_KEY="Your Private key"
- Open the file controllers/UserController.js and modify the hostname in line 31 that forms the hostname part of the verification link.
- Open the file views/partials/head.handlebars and comment line 12 that redirects the traffic to HTTPS for the web application to work on localhost.
STEP 6: If all the above steps are completed successfully then you can start the bare minimum web application host [Few of the essential features on work online when hosted on a cloud service provider like Amazon Web Services]
- Run the following Command and open localhost on a browser
node app.js
>>> Output on console will be
'Express started on http://localhost:3000 press Ctrl-C to terminate'
Now you can register as a new user and start using the web application. Once you get the
You can get an SSL Certificate for your web application from https://www.sslforfree.com/. This will enable make all the data transfer on your website secure. More importantly the web application uses native HTML5 geolocation API, which works fine on localhost but fails to work once hosted on AWS or other hosting. The part to install this certificate on AWS will be covered in upcoming sections.
NOTE: This step is one of the step in AWS deployment but mentioned as separate step so that can be used in any other project.
Please follow the step mentioned in the Google reference doc here. Once you get the analytics code you can replace it in the file views/partials/head.handlebars, lines 22 through 28. Google Analytics is a brilliant tool to understand and track Daily user activities and other details.
-
Installing Node.js on Elasticbeanstalk: If you dont know what Elasticbeanstalk is please watch this short video (recommended) before you start. The instructions are explained clearly and exhaustively in this link
-
Installing MongoDB in the EC2 instance of the Elasticbeanstalk application: Once you have SSH access to the EC2 instance that is being used for your application, please use Putty or Terminal to remotely login into the server. Once you are looged in follow the steps mentioned in the link to install MongoDB service which can be connected locally by the Node.js service.
-
Installing SSL certificate: It has two steps, first is to get a certificate [instructions mentioned in previous section]. This certificate then needs to be registered on your AWS account. Please follow the instruction in the link to import the certificate. Next use this configured certificate in your elasticbeanstalk application. The instructions are mentioned in this link
- Chirag Jain - [email protected] - github
- Ankit Jain - [email protected] - github
- Nirav Jain - [email protected] - github
- Rishabh Jain - [email protected] - github
- Pratik Kumar Jain - [email protected] - github
This project is licensed under the MIT License - see the LICENSE file for details