append useful documentation about using cocoapods

Author: AurelGit

README.md

@@ -70,6 +70,7 @@ You also need to install the dependencies required by React Native:
 - for [Android development](https://facebook.github.io/react-native/docs/getting-started.html#installing-dependencies-3)
 - for [iOS development](https://facebook.github.io/react-native/docs/getting-started.html#installing-dependencies)
 
+
 ## Using the boilerplate
 
 To create a new project using the boilerplate:
@@ -95,10 +96,15 @@ Assuming you have all the requirements installed, you can setup and run the proj
 
 ## Useful documentation
 
-### Distribute beta builds
+### Deployment
 
 [Distributing beta builds](docs/beta%20builds.md)
 
+
+### Package dependencies
+
+[Using CocoaPods to manage your packages](docs/setup%20cocoapods.md)
+
 ## License
 
 This project is released under the [MIT License](LICENSE).

docs/setup cocoapods.md

@@ -0,0 +1,88 @@
+# Setup CocoaPods
+
+[CocoaPods](https://cocoapods.org/) is a package management tool for iOS and macOS development.  
+You can use it to add the actual React Native framework code into our project, and especially to manage thirdparties packages.
+
+In this boilerplate, we don't want to make CocoaPods as a required tool.  
+But if you planned to manage a lot of thirdparty dependencies, it should be a really good idea to follow this guide. 
+
+Finally, I didn't specify it yet, but this tool is for iOS dependencies only. On Android, react-native linking is enought.
+
+_You can read more why using CocoaPods can help you to avoid a lot of constraints [on this great article](https://engineering.brigad.co/demystifying-react-native-modules-linking-ae6c017a6b4a) from Brigad._
+
+
+## Setup CocoaPods
+
+First you must install CocoaPods :
+```bash
+brew install cocoapods
+```
+
+Then simply create a `Podfile` file, which will be the configuration file of all your dependencies.  
+The easiest way is bu running :
+```bash
+cd ios
+pod init
+```
+
+## Package management
+
+### React Native framework
+
+One of the main thing you must know about using CocoaPods, is that we need to manage React itself as a pod dependency to make it works well.  
+It means that you can decide what parts of React Native framework you would like to integrate into your app. So you must not forget to append each React Native `subspec` inside the [podfile]().  
+This part is fully explained in the [official React Native documentation](https://facebook.github.io/react-native/docs/integration-with-existing-apps#configuring-cocoapods-dependencies)
+
+So, add the following into your `Podfile` :
+```
+# The target name is most likely the name of your project.
+target 'NumberTileGame' do
+
+  # Your 'node_modules' directory is probably in the root of your project,
+  # but if not, adjust the `:path` accordingly
+  pod 'React', :path => '../node_modules/react-native', :subspecs => [
+    'Core',
+    'CxxBridge', # Include this for RN >= 0.47
+    'DevSupport', # Include this to enable In-App Devmenu if RN >= 0.43
+    'RCTText',
+    'RCTNetwork',
+    'RCTWebSocket', # Needed for debugging
+    'RCTAnimation', # Needed for FlatList and animations running on native UI thread
+    # Add any other subspecs you want to use in your project
+  ]
+  # Explicitly include Yoga if you are using RN >= 0.42.0
+  pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga'
+
+  # Third party deps podspec link
+  pod 'DoubleConversion', :podspec => '../node_modules/react-native/third-party-podspecs/DoubleConversion.podspec'
+  pod 'glog', :podspec => '../node_modules/react-native/third-party-podspecs/glog.podspec'
+  pod 'Folly', :podspec => '../node_modules/react-native/third-party-podspecs/Folly.podspec'
+
+end
+```
+
+Your are now ready to install your pod.
+```
+pod install
+```
+
+### Thirdparty packages
+
+On the other hand, you can really easily link librairies to your project.  
+
+You just have to append a line like the following inside your Podfile :
+```
+pod 'RNExampleLib.podspec', :path => '../node_modules/react-native-example-lib'
+```
+and run :
+```
+pod install
+```
+
+That's all ! :tada:
+
+## Key points
+
+
+- You must always use the `.xcworkspace` file inside Xcode instead of the `.xcodeproj` one.
+- Sometimes, running `react-native link  will automatically try to perform a pod install. Read carefuly each thirdparty package install doc.