@@ -100,3 +100,28 @@ cd ~/code/myapp-deploy
100100ob deploy update
101101ob deploy push
102102```
103+
104+## Building for mobile
105+
106+### Android
107+
108+Until Obelisk will be able to automate this processing via single command you are recommended to build android apps manually as follows.
109+
110+1. In your project's `default.nix` set a suitable value for `android.applicationId` and `android.displayName`.
111+1. Run `nix-build -A android.frontend -o result-android` to build the Android app.
112+1. You should see the apk file at `result-android/android-app-debug.apk`
113+
114+Now deploy the built apk file to your Android device. To do this,
115+
116+1. Enable *USB debugging* in your Android device
117+1. Connect the device using USB
118+1. Run the deploy script: `result-android/bin/deploy`
119+
120+This should copy over and install the application on your device. The name of the installed application will be what you have specified for `android.displayName` in the `default.nix`.
121+
122+#### Releasing to Play Store
123+
124+The previous section would have generated a debug version of the app. In order to build a release version:
125+
126+1. TODO
127+