/FirebaseDatabaseUI

A library of UI bindings for FirebaseDatabase-iOS, written in Swift

Primary LanguageSwift

FirebaseDatabaseUI for iOS — UI Bindings for FirebaseDatabase

FirebaseDatabaseUI is an open-source library for iOS that allows you to quickly connect common UI elements to the Firebase database for data storage, allowing views to be updated in realtime as they change, and providing simple interfaces for common tasks like displaying lists or collections of items.

FirebaseDatabaseUI is derived from Google's FirebaseUI, with the following additions: sectioning, sorting, filtering, pagination, support for generic model classes, performance improvements, and more.

Installing FirebaseDatabaseUI for iOS

FirebaseDatabaseUI supports iOS 8.0+. To install, download or clone this repository, and then drag and drop the files contained in /FirebaseDatabaseUI into your Xcode project, selecting "Copy items if needed." You will also need to install FirebaseDatabase and SwiftLCS. We recommend using CocoaPods to do this. You can do this by adding the following to your Podfile:

# Only pull in FirebaseUI Database features
pod 'Firebase/Database', '~> 1.0'

# Install SwiftLCS
pod 'SwiftLCS', '>= 1.1.0'

Make sure you also have:

platform :ios, '8.0'
use_frameworks!

Mandatory Sample Project Configuration

You can download a sample application that uses FirebaseDatabaseUI here. You have to configure the Xcode project in order to run the sample.

  1. You project should contain GoogleService-Info.plist downloaded from Firebase console.
    Copy GoogleService-Info.plist into sample project folder (samples/obj-c/GoogleService-Info.plist or samples/swift/GoogleService-Info.plist).
    Find more instructions and download a plist file from the Firebase console.

  2. Don't forget to configure your Firebase App Database using Firebase console.
    Database should contain appropriate read/write permissions.

  3. Run 'pod install' in the directory of the sample project to install necessary dependencies.