https://github.com/YashInTech/wander-path-ai
WanderPathAI is an AI-powered trip planner that creates personalized itineraries, including routes, activities, & hotel suggestions. It integrates Google Maps & Places APIs for real-time data, Google Gemini for AI-driven recommendations, uses Google OAuth for secure authentication & Firebase Firestore for data storage, with a responsive frontend.
https://github.com/YashInTech/wander-path-ai
ai-trip-planner api firebase-firestore-database google-ai-studio google-cloud-platform tailwind-css vite-react
Last synced: about 1 month ago
JSON representation
WanderPathAI is an AI-powered trip planner that creates personalized itineraries, including routes, activities, & hotel suggestions. It integrates Google Maps & Places APIs for real-time data, Google Gemini for AI-driven recommendations, uses Google OAuth for secure authentication & Firebase Firestore for data storage, with a responsive frontend.
- Host: GitHub
- URL: https://github.com/YashInTech/wander-path-ai
- Owner: YashInTech
- License: mit
- Created: 2024-12-10T18:14:26.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-07-29T06:29:59.000Z (2 months ago)
- Last Synced: 2025-07-29T06:44:05.986Z (2 months ago)
- Topics: ai-trip-planner, api, firebase-firestore-database, google-ai-studio, google-cloud-platform, tailwind-css, vite-react
- Language: JavaScript
- Homepage: https://wander-path-ai.vercel.app
- Size: 2.2 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WanderPathAI
AI-powered trip planner that generates personalized itineraries using Gemini AI. Built with React.js for the frontend, Firebase for backend services, and Google Maps API for location features. This app helps users plan trips with custom recommendations for hotels, activities, and daily itineraries.
# React + Vite
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
Currently, two official plugins are available:
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
## Project Setup
To get started with the project, follow these steps:
### 1. Clone the Repository
First, clone the repository to your local machine:
```bash
git clone https://github.com/YashInTech/WanderPathAI.git
cd WanderPathAI
```
### 2. Install Dependencies
Install all the dependencies listed in package.json by running:
```bash
npm install
```
This will download all the necessary packages, including libraries and tools required to run the project.
### 3. Run npx Commands for Setup
Some features of this project require the use of npx to install and configure components dynamically. After setting up the project, you may need to run specific npx commands to add functionality or components to your project. These commands do not require you to install anything globally — npx will automatically download and run the necessary packages.
```bash
npx shadcn@latest add button
npx shadcn@latest add input
npx shadcn@latest add sonner
npx shadcn@latest add dialog
npx shadcn@latest add popover
```
This command will automatically add the components to the project, and you’ll be able to use it right away.
### 4. Run the Development Server
Once everything is set up, start the development server with:
```bash
npm run dev
```
Visit http://localhost:5173 to see your project in action!
Notes:
If you encounter any issues with npx, ensure that you have a stable internet connection, as npx fetches the latest version of the required tools or components from the npm registry.
The npx commands are designed to make the setup process easier by installing packages on the fly, without requiring global installation or manual steps.
Make sure to run the appropriate npx commands for any additional components or tools your project needs.
Additional Information
React: The frontend is built using React.js.
Firebase: Used for backend services like authentication, database, and hosting.
Google Maps API: Integrated for location-based services like viewing destinations and generating routes.
Gemini AI: Powers the itinerary recommendations and trip planning.
Feel free to reach out if you have any issues or questions!