Salesforce $1M Hackathon Survival Kit
The hackathon runs from October 10th through the 12th. That means you have just two days to build the best mobile app on Salesforce technology and win part of the $1M in prizes. You can’t afford to waste a minute on anything besides building a great unique experience on Salesforce!
So, to help you get up and running as quickly as possible, we’ve partnered with the Salesforce team to bring you the [Ionic Salesforce Survival Kit](https://github.com/driftyco/ionic-starter-salesforce), a pre-configured Ionic app template complete with everything you need to connect to the Salesforce platform and build your UI.
Don’t know native development? Perfect! Ionic apps use only web technologies like AngularJS and run on both iOS and Android without any extra work.
First, you’ll need to install Ionic and Cordova. Our Getting Started page can help you with that. These tools let you create, build, test, and run your mobile apps in the browser and on your devices.
We recommend doing this before the Hackathon so there are no issues when the competition stars.
Once everything is installed, test out the Ionic command to see if you can start and build an app:
$ ionic start myApp salesforce
$ cd myApp
This will create the project and download the Salesforce kit. Then, we need to add a Salesforce OAuth plugin:
$ ionic plugin add https://github.com/forcedotcom/SalesforceMobileSDK-CordovaPlugin
Now we can configure our device platform and test the app!
$ ionic platform add ios (or android for windows developers)
$ ionic build ios
$ ionic emulate ios
This should open the simulator with the real app running right on the phone, just like this:
Note: for Android developers we recommend testing directly on the device, so substitute
ionic emulate for
ionic run. If you need help installing all the dependencies for Android development or are using a Windows computer, we recommend our Ionic Box project which helps simplify the configuration of a development environment.
One of the hardest and most time consuming parts of app development is adding authentication. With the Ionic Salesforce Starter app, you get force.com authentication for free.
All you need to do is edit the
bootconfig.json file and add your production force.com application information. If you don’t have a force.com application created yet, just create a new Connected App in salesforce and add the Connected App ID and Callback URI to the
Where to go from here
If everything worked, you now have a ready-to-go template for building an Ionic app with AngularJS and the Salesforce platform. To learn more about how to use Ionic
and all of the components available, take a look at our docs. For AngularJS help, take a look at the great Thinkster.io tutorial on Angular, or Fullstack, or egghead.io.
For more info on extending this starter project, take a look at the README for the project.
Good luck at the Hackathon!