update project documentation

Author: yramanchuk

README.md

@@ -60,6 +60,30 @@ $ cd FirebaseUI-iOS
 $ pod install
 ```
 
+## Mandatory Sample Project Configuration
+
+You have to configure Xcode project in order run samples.
+
+1. You project should contain `GoogleService-Info.plist` downloaded from [Firebase console](https://console.firebase.google.com).<br>
+Find more instructions and download a plist file from the [Firebase console](https://console.firebase.google.com).
+
+2. Update URL Types.<br>
+Go to `Project Settings -> Info tab -> Url Types` and update values for:
+	+ `REVERSED_CLIENT_ID` (get value from `GoogleService-Info.plist`)
+	+ `fb{your-app-id}` (put Facebook App Id)
+	+ `twitterkit-{consumer-key}` (put Twitter App Consumer key)
+
+3. Update `Info.plist` twitter and facebook configuration values
+	+ `FacebookAppID -> {your-app-id}` (put Facebook App Id)
+	+ `Fabric -> Kits -> KitInfo -> consumerKey / consumerSecret` (put Twitter App consumer key/secret). Please notice that's it's not secure to store `consumerSecrent` in the app itself.
+
+4. Enable Keychain Sharing.<br>
+Facebook SDK requires keychain sharing.<br>
+This can be done here: `Project Settings -> Capabilities -> KeyChain Sharing -> ON`
+
+5. Don't forget to configure your Firebase App Database using Firebase Console.<br>
+Database should contain appropriate read/write permissions and folders (`objc_demo-chat` and `swift_demo-chat` respectfully)
+
 ## Contributing to FirebaseUI
 
 ### Contributor License Agreements

samples/objc/README.md

@@ -18,3 +18,24 @@ open FirebaseUI-demo-objc.xcworkspace
 ```
 Once you've opened the workspace, go into `Supporting Files/Info.plist` and either fill in the social provider information currently commented out, or delete extra providers you're not interested in. For providers you choose to keep, enable them in your Firebase Dashboard according to the [user authentication docs](https://www.firebase.com/docs/ios/guide/user-auth.html). In `ViewController.m` make sure to only enable providers that you've configured properly.
 
+
+###Project configuration
+
+Please follow steps described [here](https://github.com/firebase/FirebaseUI-iOS#mandatory-sample-project-configuration) in order to run sample project.
+
+###Chat Sample
+
+This sample uses [anonymous authentication](https://firebase.google.com/docs/auth/ios/anonymous-auth),
+so make sure anonymous auth is enabled in Firebase console.
+
+###Auth Sample
+
+This sample uses [email/password](https://firebase.google.com/docs/auth/ios/password-auth),
+[Google](https://firebase.google.com/docs/auth/ios/google-signin),
+and [Facebook](https://firebase.google.com/docs/auth/ios/facebook-login)
+auth, so make sure those are enabled in Firebase console.
+
+The auth example requires a little more setup (adding url schemes, etc)
+since it depends on the various keys and tokens for the different auth
+services your app will support. Take a look at the [Auth README](../../FirebaseAuthUI/README.md) 
+for more information.

samples/swift/README.md

@@ -12,6 +12,10 @@ project root and the project should build correctly.
 Find more instructions
 and download a plist file from the [Firebase console](https://console.firebase.google.com).
 
+###Project configuration
+
+Please follow steps described [here](https://github.com/firebase/FirebaseUI-iOS#mandatory-sample-project-configuration) in order to run sample project.
+
 ###Chat Sample
 
 This sample uses [anonymous authentication](https://firebase.google.com/docs/auth/ios/anonymous-auth),