Friendly Pix iOS

FriendlyPix is a simple app to capture and share your favorite moments. It demonstrates the best practises of building an iOS app on the Firebase Platform. Follow interesting accounts of your choice. Interact with them through the comments. Stay up-to-date with the latest photos posted in the community.

Use FriendlyPix to:

Post photos you want to keep on your profile grid.
Search profiles for friends and family.
Follow accounts to add photos from them in your Home feed.
Explore the latest photos from the Trending feed.
Interact with community through the comments under each photo.

Initial setup, build tools and dependencies

Friendly Pix iOS is built using Swift and Firebase. The Auth flow is built using Firebase-UI. Dependencies are managed using CocoaPods. Additionally server-side micro-services are built on Cloud Functions for Firebase.

Simply install the pods and open the .xcworkspace file to see the project in Xcode.

$ pod install
$ open your-project.xcworkspace

Create Firebase Project

Create a Firebase project using the Firebase Console.
To add the FriendlyPix app to a Firebase project, use the bundleID com.google.firebase.friendlypix.
Download the generated GoogleService-Info.plist file, and copy it to the root directory of this app.

Google Sign In Setup

Go to the Firebase Console and navigate to your project:
- Select the Auth panel and then click the Sign In Method tab.
- Click Google and turn on the Enable switch, then click Save.
Open your regular Info.plist, navigate to URL types > Item 0 > URL schemes, and replace the value of YOUR_REVERSED_CLIENT_ID with the value of REVERSED_CLIENT_ID from the GoogleService-Info.plist`.
Run the app on your device or simulator.
- Select Sign In and select Google to begin.

Facebook Login Setup

Go to the Facebook Developers Site and follow all instructions to set up a new iOS app. When asked for a bundle ID, use com.google.firebase.quickstart.AuthenticationExample.
Go to the Firebase Console and navigate to your project:
- Select the Auth panel and then click the Sign In Method tab.
- Click Facebook and turn on the Enable switch, then click Save.
- Enter your Facebook App Id and App Secret and click Save.
Open your regular Info.plist and replace the value of the FacebookAppID with the ID of the Facebook app you just created, e.g 124567. Save that file.
In the Info tab of your target settings add a URL Type with a URL Scheme of 'fb' + the ID of your Facebook app, e.g. fb1234567.
Run the app on your device or simulator.
- Select Sign In and select Facebook to begin.

Requirements

The mobile FriendlyPix app need the Cloud Functions, the Realtime Database rules and the Cloud Storage rules to be deployed to work properly. You can find instructions at FriendlyPix Web Repository.

Contributing

We'd love that you contribute to the project. Before doing so please read our Contributor guide.

greg-dennis/friendlypix-ios