Skip to content

This application will allow users to find their dream dog anywhere in the United States! Users may search by the breed of their choice, temperament, or let us surprise you and pick a dog for you!

License

Notifications You must be signed in to change notification settings

jtbataille/Dream-Dog-App

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dream Dog

License: MIT

Find your dream dog in your state or discover a surprise dog in your state using the Surprise Me feature.

Table of contents

General Info

An application that runs in a browser and features dynamically updated HTML, CSS, and JavaScript. Utilizes The Dog API and PetFinder API to allow a user to search for dogs in a selected state by either inputting a breed type or both a breed group and temperament. Users may alternatively select "Surpise Me" and a state to find a random dog.

Technologies

  • The Dog API
  • PetFinder API
  • Bootstrap 4.5
  • jQuery
  • Font Awesome

Features

  • Pulls dog breeds, information, and pictures from The Dog API
  • Searches for selected breeds in specified state using PetFinder API
  • Provides a link to the available dogs in PetFinder in the selected state

How to Use

  • The application has multiple options for searching for a dog:

    • Selecting a state and breed type

    • Selecting a state, breed group and/or temperament

    • Selecting a state and Surprise Me.

  • Option 1: Upon entering the application, select a state, then type in a specific breed group (ex. Golden Retriever, Boxer, Bulldog, etc) and press the Submit button.

    • If a state or breed group is not selected, the user will receive an error message asking that they make the selection(s).
  • Option 2: Upon entering the application, select a state, then select a breed type and/or temperment, and press the Submit button.

    • If a state, breed type, and/or temperament is not selected, the user will receive an error message asking that they make the selection(s).
  • Option 3: Upon entering the application, select a state and then press the Surprise Me button.

    • If a state is not selected, the user will receive an error message asking that they make the selection.
  • After performing one of the three options, one or more cards will appear, each with a picture of and information about a breed group.

  • In each card will be a Select Me button. Choosing this button will cause dogs to appear in the Available Dogs box.

    • If the selected breed group is not available in the state chosen from the dropdown, an error message saying, "Breed group is not available in selected state. Please search again" will appear.
  • After searching for a dog, the user may select either Yes or No for a specific search result.

    • Selecting Yes will either pull up one or more results with the dog breed in a selected state or will result in an error message saying that the selected dog breed is not available in that state.

    • Selecting No will clear all search results and search fields.

  • When the user selects Yes for a specific breed and that breed is available in the selected state, the results with available dogs will display a picture of a dog, its primary and (if applicable) secodary breed, as well as a Pick Me! Pick Me! button.

  • Selecting the Pick Me! Pick Me! will redirect the user to the PetFinder website where the user can view more information about the dog.

  • If the user would like to perform a new search or select new fields, they may use the Clear button to empty all of the fields and remove any breed groups that may have appeared.

  • If the user would like to return to the top of the site, they may click the Back to Search buttons to clear results and return to the top.

  • If the user would like to clear their selections or begin a new search, they may choose the Clear button to clear the search results and search fields.

Application Demo

  • Deployed

  • Empty Submit Modal, Submit with State and Breed Type, & Back To Search functionality:

    Dream Dog! (1)

  • Surprise Me button with State, Woofs... Modal, & Clear Button functionality:

    Dream Dog! (2)

  • State, Breed Group, and Temperament Submit & Woofs... Modal functionaity:

    Dream Dog! (6)

Deployed Application Link

Contact Us

About

This application will allow users to find their dream dog anywhere in the United States! Users may search by the breed of their choice, temperament, or let us surprise you and pick a dog for you!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 46.5%
  • JavaScript 45.8%
  • CSS 7.7%