Natours

An awesome tour booking site built on top of NodeJS.

Key Features 📝

• Authentication and Authorization
  • Sign up, Log in, Logout, Update, and reset password.
• User profile
  • Update username, photo, email, password, and other information
  • A user can be either a regular user or an admin or a lead guide or a guide.
  • When a user signs up, that user by default regular user.
• Tour
  • Manage booking, check tour map, check users' reviews and rating
  • Tours can be created by an admin user or a lead-guide.
  • Tours can be seen by every user.
  • Tours can be updated by an admin user or a lead guide.
  • Tours can be deleted by an admin user or a lead-guide.
• Bookings
  • Only regular users can book tours (make a payment).
  • Regular users can not book the same tour twice.
  • Regular users can see all the tours they have booked.
  • An admin user or a lead guide can see every booking on the app.
  • An admin user or a lead guide can delete any booking.
  • An admin user or a lead guide can create a booking (manually, without payment).
  • An admin user or a lead guide can not create a booking for the same user twice.
  • An admin user or a lead guide can edit any booking.
• Reviews
  • Only regular users can write reviews for tours that they have booked.
  • All users can see the reviews of each tour.
  • Regular users can edit and delete their own reviews.
  • Regular users can not review the same tour twice.
  • An admin can delete any review.
• Favorite Tours
  • A regular user can add any of their booked tours to their list of favorite tours.
  • A regular user can remove a tour from their list of favorite tours.
  • A regular user can not add a tour to their list of favorite tours when it is already a favorite.
• Credit card Payment

Demonstration 🖥️

Home Page :

Tour Details :

Payment Process :

Booked Tours :

User Profile :

Admin Profile :

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 on the "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.

Build With 🏗️

• NodeJS - JS runtime environment
• Express - The web framework used
• Mongoose - Object Data Modelling (ODM) library
• MongoDB Atlas - Cloud database service
• Pug - High performance template engine
• JSON Web Token - Security token
• ParcelJS - Blazing fast, zero configuration web application bundler
• Stripe - Online payment API and Making payments on the app.
• Postman - API testing
• Mailtrap & Sendgrid - Email delivery platform
• Mapbox - Displaying the different locations of each tour.

Setting Up Your Local Environment ⚙️

Installation 🛠️

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

$ npm i
Set your env variables
$ npm run watch:js
$ npm run build:js
$ npm run start:dev (for development)
$ npm run start:prod (for production)
$ npm run debug (for debug)
$ npm start