FirstSpot - A Haven for Travelers

PROJECT DESCRIPTION AND OUTLINE

Introduction

First spot is designed for tourists so they can now explore new destinations where a guide will always be there to help you explore new paths where you can create your paths as well. Planning a multi-city trip helps you relax and stirs in an extra element of excitement since you get to explore new destinations on the go.

About Introduction and Techniques

• Search with Filters: Utilize search filters to refine results based on user ratings, alphabetical order, and budget preferences.

• Login/Sign up: Clicking the 'Sign Up' button invokes a form with two registration options. Toggle between Tourist and Tourist Guide sign-up for respective user profiles.

• Feeling Lucky: Engage the "Feeling Lucky" feature for a random location suggestion, sparking spontaneous and adventurous journeys.

• Explore: Our unique 'Explore' feature allows visitors to create their own routes. Seek suggestions from verified guides, ensuring a safe and joyful journey.

• Predefined Routes: Save time with predefined routes created by our guides. No need to spend hours planning your own route.

• Help from Tourist Guides: Choose your dedicated tourist guide for personalized route recommendations. They are available in chat to address queries about paths or destinations.

Objective of the Work

The primary aim of our website is to make it easy for travelers to explore, manage plans, and connect with popular tourist guides, ensuring a trip that is easy, convenient, and safe.

Languages and Tools:

⭐ How to get started with open source?

Getting Started with Open Source

🚀 How to Get Started

If you're new to open source, these resources will guide you through the basics of Git and GitHub.

• Watch this introductory video for a quick start
• Forking a Repository
• Cloning a Repository
• Creating a Pull Request
• Getting Started with Git and GitHub

Contributing 👨‍💻

See the CONTRIBUTING.md file for contributing to firstspot.

How to Contribute

1. Explore existing Issues or create a new issue.

2. Fork the Repository, create a branch for your work, and commit changes.

3. Create a Pull Request for community review. Add screenshots to showcase your changes.

4. Don't create PRs without creating an issue and getting assigned.

How to Make a Pull Request (PR)

1. Start by making a Fork of the firstspot repository. Click on the at the top right corner.

2. Clone your new fork of the repository in the terminal/CLI on your computer:

   git clone https://github.com/<your-github-username>/firstspot

3. Navigate to the newly created firstspot project directory:

   cd firstspot

4. Set upstream command:

   git remote add upstream https://github.com/jaysomani/firstspot

5. Create a new branch:

   git checkout -b YourBranchName

6. Sync your fork or your local repository with the origin repository:

   • In your forked repository, click on "Fetch upstream"
   • Click "Fetch and merge"

7. Make your changes to the source code.

8. Stage your changes and commit:

   ⚠️ Make sure not to run the commands git add . or git add *. Instead, stage your changes for each file/folder

   git add public

   git commit -m "<your_commit_message>"

9. Push your local commits to the remote repository:

   git push origin YourBranchName

10. Create a Pull Request!

11. Congratulations! You've made your first contribution to firstspot! 🙌🏼