This full stack web application is specially designed for persons who love travelling and going on tour vacations.
This app can be found here
The documentation of the API for this app can be found here
The API and the app itself are hosted on the same server.
This web application allows it's users to book tour vacations.
A tour refers to a series of locations, specially picked to excite the adventurous spirit of the individual who books it.
A visiting user who has not yet created an account on the app can simply see all the current tours as well as detailed information about each tour.
Once signed up or logged in, they can then book any tour of their choice.
Users can write only one review for any tour they book.
This app is built for the purpose of honing my skills in Full stack web development.
- HTML (Create the structure and content of the web pages).
- CSS (Styling of the web pages).
- PUG (Template engine for generating the web pages dynamically).
- JAVASCRIPT (Interactivity, as well as making requests to the API from the client-side).
- NODE (Run JavaScript code on the server-side).
- EXPRESS (Node framework, meant to simplify the process of building complex server-side applications).
- MONGODB (Database for data persistence).
- MONGOOSE (Interacting with mongodb).
- LEAFLET (Displaying the different locations of each tour).
- STRIPE (Making payments on the app).
- JSON WEB TOKEN (Authenticating users)
- NODEMAILER (Sending emails to users of the app)
- Users can sign up with the application.
- Users can log in and out of the application.
- Users can update and rest their password.
- Users can update their general information.
- Users can see and change their profile page.
- When you sign up, you are a regular user by default.
- 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.
- Only regular users can book tours (make a payment).
- Regular users can not book thesame tour twice.
- Regular users can see all the tours thay 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 bookng for thesame user twice.
- An admin user or a lead-guide can edit any booking.
- Only regular users can write reviews for tours which 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 thesame tour twice.
- An admin can delete any review.
- 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.
git clone https://github.com/eebadreza/Natours.gitIf you wish to play around with the code base in your local environment, do the following
* Clone this repo to your local machine.
* Using the terminal, navigate to the cloned repo.
* Install all the neccessary dependencies, as stipulated in the package.json file.
* If you don't already have one, set up accounts with: MONGODB, MAPBOX, STRIPE, SENDGRID and MAILTRAP. Please ensure to have at least basic knowledge of how these services work.
* In your .env file, set environment variables for the following:
* DATABASE=your mongodb database url
* DATABASE_PASSWORD=your mongodb password
* SECRET=your json web token secret
* JWT_EXPIRES_IN=90d
* JWT_COOKIE_EXPIRES_IN=90
* EMAIL_USERNAME=your mailtrap username
* EMAIL_PASSWORD=your mailtrap password
* EMAIL_HOST=smtp.mailtrap.io
* EMAIL_PORT=2525
* EMAIL_FROM=your real life email address
* SENDGRID_USERNAME=apikey
* SENDGRID_PASSWORD=your sendgrid password
* STRIPE_SECRET_KEY=your stripe secret key
* STRIPE_WEBHOOK_SECRET=your stripe web hook secret
* Start the server.
* Your app should be running just fine.
This project is licensed under the MIT License. The MIT License is a permissive open-source license that allows for the use, modification, and distribution of the project's source code under certain conditions. It provides flexibility for developers and contributors while ensuring that any derived works are also open source.
For a detailed overview of the rights and limitations granted by the MIT License, please refer to the LICENSE file in the root of this repository.