{"id":28236914,"url":"https://github.com/ritiksharmarj/natours","last_synced_at":"2026-04-11T03:03:49.732Z","repository":{"id":150117781,"uuid":"612143437","full_name":"ritiksharmarj/natours","owner":"ritiksharmarj","description":"An awesome tour booking web app written in NodeJS, Express, MongoDB","archived":false,"fork":false,"pushed_at":"2023-12-05T18:02:23.000Z","size":34655,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-22T11:08:42.096Z","etag":null,"topics":["axios","bcryptjs","eslint","express-js","javascipt","jsonwebtoken","mailgun","mailtrap","mongodb-atlas","mongoose","morgan","multer","node-js","nodemailer","prettier","pug","render","sharp","slugify","stripe"],"latest_commit_sha":null,"homepage":"https://natours-xbsh.onrender.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ritiksharmarj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-03-10T09:42:41.000Z","updated_at":"2025-03-20T14:12:52.000Z","dependencies_parsed_at":"2023-12-05T10:51:16.314Z","dependency_job_id":null,"html_url":"https://github.com/ritiksharmarj/natours","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ritiksharmarj/natours","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ritiksharmarj%2Fnatours","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ritiksharmarj%2Fnatours/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ritiksharmarj%2Fnatours/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ritiksharmarj%2Fnatours/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ritiksharmarj","download_url":"https://codeload.github.com/ritiksharmarj/natours/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ritiksharmarj%2Fnatours/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31667034,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","bcryptjs","eslint","express-js","javascipt","jsonwebtoken","mailgun","mailtrap","mongodb-atlas","mongoose","morgan","multer","node-js","nodemailer","prettier","pug","render","sharp","slugify","stripe"],"created_at":"2025-05-19T00:17:04.135Z","updated_at":"2026-04-11T03:03:49.700Z","avatar_url":"https://github.com/ritiksharmarj.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://natours-xbsh.onrender.com/\"\u003e\u003cimg src=\"https://github.com/ritiksharmarj/natours/assets/54701022/326dd79a-8751-4d1d-883f-b302cf0461c5\" alt=\"Natours\" width=\"200\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  Natours\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eAn awesome tour booking site built on top of \u003ca href=\"https://nodejs.org/en/\" target=\"_blank\"\u003eNodeJS\u003c/a\u003e.\u003c/h4\u003e\n\n \u003cp align=\"center\"\u003e\n \u003ca href=\"#deployed-version\"\u003eDemo\u003c/a\u003e •\n  \u003ca href=\"#key-features\"\u003eKey Features\u003c/a\u003e •\n  \u003ca href=\"#demonstration\"\u003eDemonstration\u003c/a\u003e •\n  \u003ca href=\"#update-your-profile\"\u003eUpdate your profile\u003c/a\u003e •\n  \u003ca href=\"#api-usage\"\u003eAPI Usage\u003c/a\u003e •\n  \u003ca href=\"#deployment\"\u003eDeployment\u003c/a\u003e •\n  \u003ca href=\"#build-with\"\u003eBuild With\u003c/a\u003e •\n  \u003ca href=\"#to-do\"\u003eTo-do\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e • \n  \u003ca href=\"#known-bugs\"\u003eKnown Bugs\u003c/a\u003e • \n  \u003ca href=\"#future-updates\"\u003eFuture Updates\u003c/a\u003e • \n  \u003ca href=\"#acknowledgement\"\u003eAcknowledgement\u003c/a\u003e\n\u003c/p\u003e\n\n## Deployed Version\n\nLive demo (Feel free to visit) 👉 : https://natours-xbsh.onrender.com/\n\n## Key Features\n\n- Authentication and Authorization\n  - Signup, Login and logout\n- Tour\n  - Manage booking, check tours map, check user's reviews and ratings\n- User profile\n  - Update username, profile photo, email, and password\n- Credit card payment using Stripe\n\n## Demonstration\n\n[![Natours Walkthrough](https://img.youtube.com/vi/UljiMtXeFx0/maxresdefault.jpg)](https://www.youtube.com/watch?v=UljiMtXeFx0)\n\n## How To Use\n\n### Book a tour\n\n- Login or Signup to the site\n- Search for tours that you want to book\n- Book a tour\n- Proceed to the payment using Stripe\n- Enter the card details (Test Mode):\n  ```\n  - Card No. : 4242 4242 4242 4242\n  - Expiry date: any\n  - CVV: any\n  ```\n- Finished!\n\n### Manage your booking\n\n- Check the tour you have booked in \"Manage Booking\" page in your user settings. You'll be automatically redirected to this\n  page after you have completed the booking.\n\n### Update your profile\n\n- You can update your own username, profile photo, email and password.\n\n## API Usage\n\nBefore using the API, you need to set the variables in Postman depending on your environment (development or production). Simply add:\n\n```\n- {{URL}} with your hostname as value (e.g. http://127.0.0.1:8000 or http://www.example.com)\n- {{password}} with your user password as value.\n```\n\nCheck [Natours API Documentation](https://documenter.getpostman.com/view/8689170/SVmzvwpY?version=latest) for more info.\n\n\u003cb\u003e API Features: \u003c/b\u003e\n\nTours List 👉 https://natours-xbsh.onrender.com/api/v1/tours\n\nTours Statistics 👉 https://natours-xbsh.onrender.com/api/v1/tours/tour-stats\n\nGet Top 5 Cheap Tours 👉 https://natours-xbsh.onrender.com/api/v1/tours/top-5-cheap\n\nGet Tours Within Radius 👉 https://natours-xbsh.onrender.com/api/v1/tours/tours-within/200/center/34.098453,-118.096327/unit/mi\n\n## Deployment\n\nThe website is deployed using git on render.com. Below are the steps taken:\n\n```\ngit init\ngit add -A\ngit commit -m \"Commit message\"\ngit push origin main\n\ndeploy on render \u003e web service\n```\n\nSet environment variables to render:\n\n```\ngo to dashboard \u003e project \u003e environment\n```\n\n## Build With\n\n- [NodeJS](https://nodejs.org/en/) - JS runtime environment\n- [Express](http://expressjs.com/) - The web framework used\n- [Mongoose](https://mongoosejs.com/) - Object Data Modelling (ODM) library\n- [MongoDB Atlas](https://www.mongodb.com/cloud/atlas) - Cloud database service\n- [Pug](https://pugjs.org/api/getting-started.html) - High performance template engine\n- [JSON Web Token](https://jwt.io/) - Security token\n- [esbuild](https://esbuild.github.io/) - An extremely fast bundler for the web\n- [Stripe](https://stripe.com/) - Online payment API\n- [Postman](https://www.getpostman.com/) - API testing\n- [Mailtrap](https://mailtrap.io/) \u0026 [Mailgun](https://www.mailgun.com/) - Email delivery platform\n- [Render](https://render.com/) - Cloud platform\n\n## To-do\n\n- Review and rating\n  - Allow user to add a review directly at the website after they have booked a tour\n- Booking\n  - Prevent duplicate bookings after user has booked that exact tour, implement favourite tours\n- Advanced authentication features\n  - Signup, confirm user email, login with refresh token, two-factor authentication\n- And More ! There's always room for improvement!\n\n## Installation\n\nYou can fork the app or you can git-clone the app into your local machine. Once done that, please install all the\ndependencies by running\n\n```\n$ npm i\nset your env variables\n$ npm run watch\n$ npm run dev (for development)\n$ npm run prod (for production)\n$ npm run debug (for debug)\n```\n\n## Known Bugs\n\nFeel free to create an issue for bugs or features if you run into any issues or have questions, ideas or concerns.\nPlease enjoy and feel free to share your opinion, constructive criticism, or comments about my work. Thank you! 🙂\n\n## Future Updates\n\n- Improve overall UX/UI and fix bugs\n- Featured Tours\n- Recently Viewed Tours\n- And More ! There's always room for improvement!\n\n## Acknowledgement\n\n- This project is part of the online course I've taken at Udemy. Thanks to [Jonas Schmedtmann](https://twitter.com/jonasschmedtman) for creating this awesome course!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fritiksharmarj%2Fnatours","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fritiksharmarj%2Fnatours","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fritiksharmarj%2Fnatours/lists"}