Live Demo • Report Bug • Request Feature

• 🌍 About The Project
• ✨ Key Features
• 📸 Screenshots
• 🛠️ Tech Stack
• 🧩 Architecture
• 🚀 Getting Started
• 🤝 Contributing
• 📜 License
• 📞 Contact

Problem: Traditional travel planning is time-consuming (10–15 hours/trip), fragmented, and generic.
Solution: AdventureNexus cuts this down to minutes using AI.

AdventureNexus is your intelligent travel companion. By leveraging Generative AI and real-time travel APIs, we create fully personalized travel experiences. Whether you're a backpacker on a budget or looking for luxury, our engine tailors every aspect of your trip—from destinations and daily itineraries to flight & hotel bookings.

• ⏱️ Save Time: Plan complex trips in under 2 minutes.
• 🎯 Personalized: Recommendations based on your specific interests (food, history, adventure, etc.).
• 💰 Cost-Effective: Real-time budget optimization ensures you get the best value.

Landing Page

Smart Search

Plan Review

Generated Results

• Framework: React 18
• Build Tool: Vite
• Styling: Tailwind CSS v4 & Shadcn/UI
• Icons: Lucide React
• State Mgmt: Zustand
• Animations: Framer Motion

• Runtime: Node.js & Express.js
• Database: MongoDB (NoSQL)
• Caching: Redis (via IOredis)
• Language: TypeScript

• LLM Engine: Groq SDK
• Image Gen: Pollinations AI
• Travel Data: Amadeus & Booking.com

Follow these steps to set up the project locally.

• Node.js v18+
• MongoDB (Local or Atlas)
• Redis (Optional, for caching)
• Git

1. Clone the Repo

   git clone https://github.com/yourusername/adventurenexus.git
   cd adventurenexus

2. Setup Backend

   cd Backend
   npm install
   
   # Create .env file
   cp .env.example .env
   # Add your API keys (MongoDB, Clerk, Amadeus, etc.)
   
   npm start

3. Setup Frontend

   cd ../frontend
   npm install
   
   # Create .env file
   cp .env.example .env.local
   # Add your Clerk Publishable Key & Backend URL
   
   npm run dev

4. Visit App Open http://localhost:5173 in your browser.

graph TD
    A[User Client] -->|HTTP/REST| B[Frontend (React + Vite)]
    B -->|API Calls| C[Backend (Express + Node)]
    C -->|Auth| D[Clerk]
    C -->|Read/Write| E[(MongoDB)]
    C -->|Cache| F[(Redis)]
    C -->|AI Inference| G[Groq API]
    C -->|Travel Data| H[Amadeus/Booking APIs]

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MIT License. See LICENSE for more information.

Project Link: https://github.com/Samiran2004/adventurenexus

Made with ❤️ by the AdventureNexus Team