🌍 TravelGrid

🚀 Live Demo | 📂 GitHub Repository

TravelGrid is a comprehensive, user-friendly travel platform that empowers users to effortlessly plan and book their entire trip in one place. From booking ✈️ flights and renting 🚗 vehicles to reserving 🏨 hotels and exploring detailed 📚 travel guides, TravelGrid offers customizable travel packages tailored to individual preferences—making travel planning seamless and enjoyable.

---

📖 Project Overview

TravelGrid is an open-source initiative proudly participating in GirlScript Summer of Code (GSSoC) 2025, one of India’s premier open-source mentorship programs. 🌟 GSSoC nurtures aspiring developers by providing real-world project experience, expert guidance, and community collaboration opportunities.

By contributing to TravelGrid, developers can:

• 🚀 Enhance their development skills with hands-on experience
• 🤝 Collaborate with a vibrant, supportive community
• 🌟 Make meaningful impacts on a project designed to simplify and elevate the travel experience for users worldwide

---

Project Insights

Stars	Forks	Issues	Open PRs	Closed PRs	Languages	Contributors

Getting Started

Follow these steps to set up TravelGrid locally and contribute to the project.

🛠️ Prerequisites

Before getting started, make sure you have the following installed on your system:

• Node.js (v16 or higher)
• npm or yarn
• Git
• Code editor (VS Code recommended)

Installation

1. Clone the Repository

   git clone https://github.com/Adarsh-Chaubey03/TravelGrid.git
   cd TravelGrid

2. Install Frontend Dependencies

   cd client
   npm install

   Note: If you encounter npm WARN deprecated or peer dependency errors, run:

   npm install --legacy-peer-deps

3. Install Backend Dependencies

   cd ../server
   npm install

   Note: Ensure you are in the server folder. If you encounter an ENOENT: no such file or directory error, verify the folder structure.

Running the Application

1. Start the Backend Server

   cd server
   npm start

   The server will run on http://localhost:5000.

2. Start the Frontend

   In a new terminal:

   cd client
   npm run dev

   The client will run on http://localhost:5173.

🛠️ Troubleshooting

Issue	Solution
❌ npm ERR! enoent	Make sure you're in the correct folder (client or server) before running npm install.
⚠️ Port already in use	Close other applications using the port or change the port number in vite.config.js or backend server config.
📦 Dependency errors	Run npm install --legacy-peer-deps in the frontend directory to resolve peer dependency conflicts.
🚫 Server not starting	Verify your .env file has the correct MongoDB URI and port configurations.

🤝 Contributing to TravelGrid

We warmly welcome contributions to make TravelGrid even better! To maintain quality and collaboration, please follow these guidelines:

1. 🔍 Pick an Issue
   Choose an unassigned issue from the repository or propose a new one. Please wait for admin approval before you start working.

2. 📱 Responsive Design
   Use Tailwind CSS to ensure all components are fully responsive across devices.

3. 🧹 Code Quality
   Write clean, modular, and reusable code inside the src/components/ directory. Make sure your code adheres to our ESLint and Prettier formatting standards.

4. 📤 Pull Requests (PRs)

   • Work on a specific issue.
   • Test your changes thoroughly.
   • Provide a clear, descriptive PR message explaining your changes.
   • PRs with bugs or incomplete features will not be merged.

5. 💬 Communication
   Have questions or need help? Reach out to the project admin:

   • GitHub: Adarsh-Chaubey03
   • LinkedIn: Adarsh Chaubey

Thank you for contributing and helping build an amazing travel platform! 🚀

6. Task Assignment: Task assignments and PR reviews are conducted daily from 6:00 PM to 7:00 PM IST.

Project Structure

TravelGrid/
├── client/
│   ├── public/
│   ├── src/
│   │   ├── assets/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── styles/
│   │   ├── App.jsx
│   │   ├── main.jsx
│   ├── .gitignore
│   ├── package.json
│   ├── README.md
│   ├── vite.config.js
├── server/
│   ├── config/
│   ├── controllers/
│   ├── models/
│   ├── routes/
│   ├── index.js
│   ├── .env
│   ├── README.md
├── .gitignore
├── LICENSE
├── README.md

Code of Conduct

Refer to the Code of Conduct for contributing guidelines and community standards.

Contribution Guidelines

Detailed contribution guidelines are available in the CONTRIBUTE.md file (coming soon).

Contributors

View the full list of contributors on the GitHub Contributors Graph.

Suggestions & Feedback

Submit feedback, feature suggestions, or collaboration ideas by opening an issue or discussion on the GitHub repository.

License

This project is licensed under the MIT License. See the LICENSE file for details.

👤 Project Admin

Name	Profile
Adarsh Chaubey	🔗 GitHub | 🔗 LinkedIn

Support

If you find this project valuable, please star the repository on GitHub to support its development.