# 🐶 puppypals

A social networking mobile application designed to allow local dog owners to meet, host events, chat, and organize play dates with each other.

Technologies Used

setup & configuration

frontend

backend

front-to-back

🚀 Getting Started

No matter the environment, first run npm install for all 3 packages (root, client, server).

1. Start MongoDB instance.
2. npm start in ROOTDIR/server
3. npm start in ROOTDIR/client
4. Use the corresponding keys to launch the app on your specified device.

🐾 The App

🐕 Landing Page

---

LOGIN

• Authenticates users who have already created an account
• Redirects to "Home" page on successful login
• Nav Bar (bottom) is rendered upon succesful login

SIGN UP

• Allows for creation of new account
• Validates age-appropriateness of user (client spec. of 18 yrs or older)
• "Create Account" button directs new user to set up profile
• User uploads one Human pic
• User uploads one main Dog pic, and up to five additional Dog pics
• User builds profile w/ variety of text inputs and dropdown inputs
• Upon successful account creation, new user is redirected to "Home" page
• Nav Bar (bottom) is rendered

🦴 Home Page

---

MAIN VIEW

• Swipe right to send a friend invite
• Swipe left to pass
• Use the ... button to filter dogs

DETAIL VIEW

• Access by tapping main image
• Shows additional information about current dog & its owner (user)
• "Friendly" tags are conditionally rendered if they are `true`
• Swiping/cycling thru dogs is still possible

🐩 Invites & Messaging

---

PENDING INVITES

• Shows "invites", i.e. other users who have swiped right on your dog
• Similar to home page, swipe right to accept invite, swipe left to reject
• Future Enhancement: tap invite to see associated profile

ACCEPTED & MESSAGING

• "Accepted" layout same as "Pending
• "Contains users whom you have swiped right to accept their invite, or vice-versa
• Tapping on a user in "accepted" brings up a chat view, with real-time messaging & emoji reaction capability

🌭 Events

---

INVITES & ATTENDING

• Shows events user is invited to/attending, based upon selected view
• Tapping on an event brings up details for the associated event
• User can RSVP to an event ("Invited" view) within event details modal

CREATE EVENT

• Upon tapping ➕ icon, user can create a new event
• User can invite friends to the event before saving/creating

🦮 Profile

---

PROFILE VIEW

• Displays profile of the current user
• Renders available pics, information, and conditional "friendly" tags
• Tapping pencil brings up edit feature

EDIT PROFILE

• Allows customization of all dog pics
• City & State can be changed
• Bio can be edited
• All unedited/untouched items remain the same as pre-editing
• User has option to discard edits with "Go Back" button
• Future enhancement: Street address can be changed

The Team

Jacob Fink (Project Manager)
Josh Jang
Aimee Kang (UI Co-Manager)
Terrence Koo
Bolton Lin (Architecture Manager)
Arpan Shrestha
Tom Spitz (UI Co-Manager)

Conclusion

We hope you love Puppypals as much as we do!