Skip to content

arpit-925/Buddy_Finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

55 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌍 Buddy Finder

Buddy Finder is a full-stack travel companion platform where users can create trips, find travel buddies, and explore trips based on preferences like budget, season, and travel type.


✨ Features

πŸ‘€ Authentication

  • User registration with email verification
  • Secure login using JWT
  • Protected routes

🧳 Trips

  • Create, edit, delete trips
  • Join trips created by others
  • Trip status (OPEN / CLOSED)
  • Host controls (edit/delete own trips)

πŸ” Explore Trips

  • Search by destination
  • Filter by budget, availability, and status
  • Smart recommendations based on:
    • User preferences
    • Season
    • Travel type
  • Suggested places with auto-fill trip creation

πŸ—ΊοΈ Maps

  • Mapbox integration
  • Select trip location via interactive map
  • View trip locations visually

πŸ‘€ Profile

  • Edit profile details
  • Upload profile image (Cloudinary)
  • Set travel preferences (budget, travel type)
  • View created & joined trips

πŸ”” Notifications

  • Real-time notifications using Socket.IO

πŸ›  Tech Stack

Frontend

  • React + Vite
  • Tailwind CSS
  • React Router
  • Axios
  • Mapbox GL JS

Backend

  • Node.js
  • Express.js
  • MongoDB + Mongoose
  • JWT Authentication
  • Socket.IO
  • Cloudinary (image uploads)

πŸ“ Project Structure

BuddyFinder/ β”‚ β”œβ”€β”€ frontend/ β”‚ β”œβ”€β”€ src/ β”‚ β”œβ”€β”€ public/ β”‚ └── vite.config.js β”‚ β”œβ”€β”€ backend/ β”‚ β”œβ”€β”€ controllers/ β”‚ β”œβ”€β”€ routes/ β”‚ β”œβ”€β”€ models/ β”‚ β”œβ”€β”€ middleware/ β”‚ └── server.js β”‚ └── .gitignore

Email Delivery Note

Email delivery may be delayed by 2–5 minutes when using free hosting services due to server cold starts.

Free SMTP providers (e.g., Gmail) may queue or scan emails, causing additional delay.

For instant email delivery, it is recommended to use a transactional email service like SendGrid / Resend / Brevo in production.

πŸ‘¨β€πŸ’» Author

Arpit Mishra Full-Stack Developer

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages