Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/firebase/friendlypix-ios

Friendly Pix iOS is a sample app demonstrating how to build an iOS app with the Firebase Platform.
https://github.com/firebase/friendlypix-ios

firebase photos

Last synced: 3 months ago
JSON representation

Friendly Pix iOS is a sample app demonstrating how to build an iOS app with the Firebase Platform.

Host: GitHub
URL: https://github.com/firebase/friendlypix-ios
Owner: firebase
License: apache-2.0
Archived: true
Created: 2017-07-18T22:10:37.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2022-11-09T17:49:45.000Z (about 2 years ago)
Last Synced: 2024-09-19T12:05:28.357Z (3 months ago)
Topics: firebase, photos
Language: Swift
Homepage: https://itunes.apple.com/us/app/friendlypix/id1318492920
Size: 10.6 MB
Stars: 163
Watchers: 60
Forks: 54
Open Issues: 1
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

# 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](https://firebase.google.com/docs/ios/setup). The Auth flow is built using [Firebase-UI](https://github.com/firebase/firebaseui-ios). Dependencies are managed using [CocoaPods](https://cocoapods.org/). Additionally server-side micro-services are built on [Cloud Functions for Firebase](https://firebase.google.com/docs/functions).

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

```
$ pod install
$ open your-project.xcworkspace
```

## Create Firebase Project

1. Create a Firebase project using the [Firebase Console](https://firebase.google.com/console).
1. To add the FriendlyPix app to a Firebase project, use the bundleID `com.google.firebase.friendlypix`.
1. 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](https://console.firebase.google.com) 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](https://developers.facebook.com) 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](https://console.firebase.google.com) 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](https://github.com/firebase/friendlypix-web/blob/master/README.md#mobile-apps).

## Contributing

We'd love that you contribute to the project. Before doing so please read our [Contributor guide](../CONTRIBUTING.md).

## License