Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Peehu1308/TravelGrid

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TravelGrid

Live Demo | GitHub Repository

TravelGrid is an all-in-one travel platform that enables users to book tickets, rent vehicles, reserve hotels, access travel guides, and select customizable travel packages seamlessly.

Project Overview

TravelGrid is an open-source project participating in GirlScript Summer of Code (GSSoC) 2025, one of India’s largest open-source programs. GSSoC encourages developers to contribute to real-world projects, fostering skill development, collaboration, and recognition through mentorship and community support.

Project Insights

Stars Forks Issues Open PRs Closed PRs Languages Contributors
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

  • 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 Verify you are in the correct folder (client or server) before running npm install.
Port already in use Stop other applications using the port or modify the port in vite.config.js or the backend server configuration.
Dependency errors Run npm install --legacy-peer-deps for the frontend.
Server not starting Ensure the .env file contains the correct MongoDB URI and port settings.

Contributing to TravelGrid

We welcome contributions to enhance TravelGrid. Follow these guidelines:

  1. Pick an Issue: Select an unassigned issue from the repository or create a new one. Wait for admin approval before starting.

  2. Responsive Design: Use Tailwind CSS to ensure responsive designs.

  3. Code Quality: Write clean, modular code in the src/components/ directory. Adhere to ESLint and Prettier standards.

  4. Pull Requests: Address a specific issue, test thoroughly, and provide a clear PR description. Buggy PRs will not be merged.

  5. Communication: Contact the project admin via:

  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.

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 93.4%
  • CSS 5.7%
  • HTML 0.9%