Home - Kaleemunnisa/CS691-Spring2025-Team6 GitHub Wiki

TravelGuide - Smart Travel Companion

Travel Guide

๐Ÿš€ Problem Statement

Traveling to new destinations can often be overwhelming for tourists due to the lack of accessible and personalized information about local attractions, accommodations, and events. Tourists frequently struggle to find reliable recommendations for entertainment spots, places to stay, and upcoming events, leading to a less enjoyable travel experience. Additionally, local businesses often face challenges in attracting tourists, resulting in missed opportunities for growth.

Hypothesis

By developing a smart travel app that provides real-time, location-based recommendations and integrates with local businesses, we can simplify travel planning for tourists while boosting visibility and customer engagement for local businesses. This triangular business model will create a win-win situation for both tourists and local enterprises.


๐Ÿ›  Technologies

Frontend
React Native

React Native

TypeScript

TypeScript

JavaScript

JavaScript

CSS

CSS

Backend
Node.js

Node.js

Fast API

Fast Api

CSS

Python

Firestore

Firestore

APIs & Services
Ticketmaster API

Ticketmaster API

Firebase

Firebase

Firebase Authentication

Firebase Auth

GeoAPIfy

GeoAPIfy

Tools
Git

Git

GitHub

GitHub

Jira

Jira

VS Code

VS Code


๐Ÿ’ป Installation

To get the project up and running locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/Kaleemunnisa/CS691-Spring2025-Team6.git
    cd CS691-Spring2025-Team6
  2. Install dependencies:

    For the frontend (Expo/React Native):

    cd frontend
    npm install
  3. Set up Firebase:

  4. Start Expo Development Server:

    • Go to the frontend directory and run:
    cd frontend
    npx expo start

    This will start the Expo development server, and you'll see a QR code in the terminal or a link to open the app in the Expo Go app on your phone or in a simulator.

    • If you don't have the Expo Go app installed, you can download it from the App Store (iOS) or Google Play Store (Android).
    • Alternatively, you can run the app in an iOS simulator or Android emulator.

Key Updates for Expo:

  • You only need to install Expo CLI and run npx expo start to start the frontend.
  • Expo Go will be used for testing the app on your device.
  • If youโ€™re using Expo Managed Workflow, thereโ€™s no need for a physical Android/iOS device for testing, as it works with simulators or Expo Go on any device.

โš ๏ธ **GitHub.com Fallback** โš ๏ธ