Skip to content
Pocket Passport
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Pocket Passport is a travel photo guide that allows users to find travel destinations and save pictures, and also see Yelp and Googlemaps information to find more details about the business and location. The pictures are sourced from Flickr.

Table of Contents

Technologies Used

Backend: Python, Flask, PostgreSQL, SQLAlchemy
Frontend: JavaScript, jQuery, AJAX, Jinja2, Bootstrap, HTML5, CSS3, Masonry
APIs: Flickr, Yelp, Googlemaps


Users can save photos to their profile, view pictures based on different categories, and see Googlemaps and Yelp information.

The home page shows pictures previously saved by the user using a SQLalchemy database query. alt text

After entering a location in the search bar, users can choose a category of pictures to view. alt text

Users can then like or unlike pictures to save to their profile. Pictures are filtered to contain geodata. alt text

Click the picture to view more details. The yelp location and rating are displayed by entering the latitude longitude data retrieved from Flickr, and reverse geocoding for a formatted address. alt text

See googlemaps directions alt text "

Future Improvements

  • Add an infinite scroll/pagination
  • Expand the app to allow friends to share photos with each other and view profiles more easily
  • Add modals for pictures to pop up.


Hello! My name is Christina Gin and I am a software engineer. I received training from Hackbright Academy, an engineering bootcamp for women in San Francisco. Thanks for reading!


Clone or fork this repo

Create and activate a virtual environment inside your directory

virtualenv env
source env/bin/activate

Install the dependencies:

pip install -r requirements.txt

Sign up to obtain keys for the Flickr API, Yelp API, and Googlemaps API

Save your API keys in a file called using this format:


Source your keys from your file into your virtual environment:


Set up the database


Run the app:


You can now navigate to 'localhost:5000/' to access Pocket Passport

You can’t perform that action at this time.