Demo

I have placed a demo on my personal server for those that want to see the app running live:

Our App is also Available, for Free, on iOS & Android

Android
iOS

Requirements

PhoneGap v3.5+
Xcode
Android SDK
Node.js v10+ ( For Application Development )

Facing App Installation

To use this repository you will first need to create a PhoneGap application. You can do so by manually running the commands below in your terminal window, or run the shell script in ./build/scripts/install.sh which contains the same content.

Automatic Installation ( do you trust me? ):

You can install the Facing App via the command line with either curl or wget which will run this Shell Script.

via `curl`:

cd /your/project/folder
curl -L https://raw.githubusercontent.com/facingapp/phonegap-app/stable/build/scripts/install.sh | sh

via `wget`:

cd /your/project/folder
wget --no-check-certificate https://raw.githubusercontent.com/facingapp/phonegap-app/stable/build/scripts/install.sh -O - | sh

NOTE:

You will need to modify ./www/assets/js/config.js to your projects specifications. Also, you will still need to make the changes listed below in the iOS Build Settings.

Manual Installation:

#1. PhoneGap Installation:

cd /your/project/folder
npm update -g phonegap cordova grunt-cli

#2. Creating PhoneGap Project:

phonegap create facing com.manifestinteractive.com Facing
cd facing

#3. Clone Facing App Repository:

rm -fr www
git clone -b stable https://github.com/facingapp/phonegap-app.git www

#4. Setup Grunt:

cd www
npm install
gem install sass
grunt
cd -

#5. Copy Config File:

cp www/assets/js/config.dist.js www/assets/js/config.js

NOTE: You will need to modify ./www/assets/js/config.js to your projects specifications.

#6. Installing Required Plugins:

cordova platform add ios
cordova platform add android
cordova plugin add com.google.cordova.admob
cordova plugin add org.apache.cordova.battery-status
cordova plugin add org.apache.cordova.contacts
cordova plugin add org.apache.cordova.device
cordova plugin add org.apache.cordova.device-motion
cordova plugin add org.apache.cordova.device-orientation
cordova plugin add org.apache.cordova.dialogs
cordova plugin add org.apache.cordova.geolocation
cordova plugin add org.apache.cordova.globalization
cordova plugin add org.apache.cordova.inappbrowser
cordova plugin add org.apache.cordova.network-information
cordova plugin add org.apache.cordova.splashscreen
cordova plugin add https://github.com/aharris88/phonegap-sms-plugin.git
cordova plugin add https://github.com/danwilson/google-analytics-plugin.git
cordova plugin add https://github.com/EddyVerbruggen/Insomnia-PhoneGap-Plugin.git
cordova plugin add https://github.com/EddyVerbruggen/LaunchMyApp-PhoneGap-Plugin.git --variable URL_SCHEME=facing
cordova plugin add https://github.com/katzer/cordova-plugin-email-composer.git
cordova plugin add https://github.com/mkuklis/phonegap-websocket
cordova plugin add https://github.com/phonegap-build/StatusBarPlugin.git
cordova plugin add https://github.com/VersoSolutions/CordovaClipboard

#7. Copy Build Hooks into Project:

cp -R www/build/hooks/* hooks/
chmod 755 hooks/*/*.js

#8. Replace iOS Build Files ( modified from default ):

rm platforms/ios/Facing/Resources/icons/*.png
rm platforms/ios/Facing/Resources/splash/*.png
rm -fr platforms/android/res/drawable*

cp www/assets/img/ios/icon/*.png platforms/ios/Facing/Resources/icons/
cp www/assets/img/ios/screen/*.png platforms/ios/Facing/Resources/splash/
cp -R www/assets/img/android/* platforms/android/res/

rm platforms/ios/Facing/Facing-Info.plist
cp www/build/ios/Facing-Info.plist platforms/ios/Facing/Facing-Info.plist

#9. Build Application & Launch in iOS Simulator:

cordova emulate ios

Build Tools:

#1. Automation Scripts:

To help speed up development, there are a few tools in ./build/scripts that you might want to check out.

facingapp.sh This is a shell script that adds aliases and commands to automate building & debugging. See the comments at the top of the file for instructions.
install.sh This is the script to automatically install and build the Facing app for you.
open-webinspector.applescript This applescript will automatically launch Apple's Safari Web Inspector for your iOS Simulator. This is used by facingapp.sh and you wont need to mess with it much.

#2. Grunt Development:

This project uses Grunt to package separate development files together. This makes the development process easier as large components are broken up into logical smaller files.

This also means that you SHOULD NOT be edting files in either assets/js or assets/css folders as these files are built from grunt.

To take advantage of Grunt during the development process, you just need to run the following command to watch for any file changes setup to rebuild the scripts used in the app.

cd /path/to/facing/www
grunt watch

If you do not want to watch for live file changes, you can use the following to repackage code as needed.

cd /path/to/facing/www
grunt js
grunt css

#3. Live Reload:

This project supports Live Reload within the App. This means that if you are running the device on an emulator, its possible to reload assets without having to relaunch the emulator from scratch. If you are using the native PhoneGap App, you will not need this functionality as that application already reloads on file change.

Facing App Node.js Server

We have also released our Node.js Server that handles device communication.

https://github.com/facingapp/node-server

License

Facing is currently licensed under the LGPL v3 license.

facingapp/phonegap-app