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.
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.
| Stars | Forks | Issues | Open PRs | Closed PRs | Languages | Contributors |
|---|---|---|---|---|---|---|
Follow these steps to set up TravelGrid locally and contribute to the project.
- Node.js (v16 or higher)
- npm or yarn
- Git
- Code editor (VS Code recommended)
-
Clone the Repository
git clone https://github.com/Adarsh-Chaubey03/TravelGrid.git cd TravelGrid -
Install Frontend Dependencies
cd client npm installNote: If you encounter npm WARN deprecated or peer dependency errors, run:
npm install --legacy-peer-deps
-
Install Backend Dependencies
cd ../server npm installNote: Ensure you are in the
serverfolder. If you encounter anENOENT: no such file or directoryerror, verify the folder structure.
-
Start the Backend Server
cd server npm startThe server will run on
http://localhost:5000. -
Start the Frontend
In a new terminal:
cd client npm run devThe client will run on
http://localhost:5173.
| 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. |
We welcome contributions to enhance TravelGrid. Follow these guidelines:
-
Pick an Issue: Select an unassigned issue from the repository or create a new one. Wait for admin approval before starting.
-
Responsive Design: Use Tailwind CSS to ensure responsive designs.
-
Code Quality: Write clean, modular code in the
src/components/directory. Adhere to ESLint and Prettier standards. -
Pull Requests: Address a specific issue, test thoroughly, and provide a clear PR description. Buggy PRs will not be merged.
-
Communication: Contact the project admin via:
- GitHub: Adarsh-Chaubey03
- LinkedIn: Adarsh Chaubey
-
Task Assignment: Task assignments and PR reviews are conducted daily from 6:00 PM to 7:00 PM IST.
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.mdRefer to the Code of Conduct for contributing guidelines and community standards.
Detailed contribution guidelines are available in the CONTRIBUTE.md file (coming soon).
View the full list of contributors on the GitHub Contributors Graph.
Submit feedback, feature suggestions, or collaboration ideas by opening an issue or discussion on the GitHub repository.
This project is licensed under the MIT License. See the LICENSE file for details.
| Name | Profile |
|---|---|
| Adarsh Chaubey | GitHub | LinkedIn |
If you find this project valuable, please star the repository on GitHub to support its development.