Skip to content

Touring servicing app made with modern technologies

Notifications You must be signed in to change notification settings

hemantmakkar/Natours

Repository files navigation


Natours
Natours

An awesome tour booking site built on top of NodeJS.

DemoKey FeaturesDemonstrationHow To UseAPI UsageDeploymentBuild WithTo-doInstallationKnown BugsFuture UpdatesAcknowledgement

Deployed Version

Live demo (Feel free to visit) 👉 : https://natours-hemant.herokuapp.com/

Key Features

  • Authentication and Authorization
    • Login and logout
  • Tour
    • Manage booking, check tours map, check users' reviews and rating
  • User profile
    • Update username, photo, email, and password
  • Credit card Payment

Demonstration

Home Page :

natoursHomePageonline-video-cutt

Tour Details :

tourOverviewonline-video-cutterc

Payment Process :

paymentprocess-1-ycnhrceamp4-7fW

Booked Tours :

rsz_bookedtours

User Profile :

rsz_userprofile

Admin Profile :

rsz_adminprofile

How To Use

Book a tour

  • Login to the site
  • Search for tours that you want to book
  • Book a tour
  • Proceed to the payment checkout page
  • Enter the card details (Test Mood):
    - Card No. : 4242 4242 4242 4242
    - Expiry date: 02 / 22
    - CVV: 222
    
  • Finished!

Manage your booking

  • Check the tour you have booked in "Manage Booking" page in your user settings. You'll be automatically redirected to this page after you have completed the booking.

Update your profile

  • You can update your own username, profile photo, email and password.

API Usage

Before using the API, you need to set the variables in Postman depending on your environment (development or production). Simply add:

- {{URL}} with your hostname as value (Eg. http://127.0.0.1:8000 or http://www.example.com)
- {{password}} with your user password as value.

Check Natours API Documentation for more info.

API Features:

Tours List 👉 https://natours-hemant.herokuapp.com/api/v1/tours

Tours State 👉 https://natours-hemant.herokuapp.com/api/v1/tours/tour-stats

Get Top 5 Cheap Tours 👉 https://natours-hemant.herokuapp.com/api/v1/tours/top-5-cheap

Get Tours Within Radius 👉 https://natours-hemant.herokuapp.com/api/v1/tours/tours-within/200/center/34.098453,-118.096327/unit/mi

Deployment

The website is deployed with git into heroku. Below are the steps taken:

git init
git add -A
git commit -m "Commit message"
heroku login
heroku create
heroku config:set CONFIG_KEY=CONFIG_VALUE
parcel build ./public/js/index.js --out-dir ./public/js --out-file bundle.js
git push heroku master
heroku open

You can also changed your website url by running this command:

heroku apps:rename natours-users

Build With

To-do

  • Review and rating
    • Allow user to add a review directly at the website after they have taken a tour
  • Booking
    • Prevent duplicate bookings after user has booked that exact tour, implement favourite tours
  • Advanced authentication features
    • Signup, confirm user email, login with refresh token, two-factor authentication
  • And More ! There's always room for improvement!

Installation

You can fork the app or you can git-clone the app into your local machine. Once done that, please install all the dependencies by running

$ npm i
set your env variables
$ npm run watch:js
$ npm run build:js
$ npm run dev (for development)
$ npm run start:prod (for production)
$ npm run debug (for debug)
$ npm start
Setting up ESLint and Prettier in VS Code 👇
$ npm i eslint prettier eslint-config-prettier eslint-plugin-prettier eslint-config-airbnb eslint-plugin-node
eslint-plugin-import eslint-plugin-jsx-a11y  eslint-plugin-react --save-dev

Acknowledgement

About

Touring servicing app made with modern technologies

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published