Salesforce just announced the return of the $1M Hackathon, this time coming to their October 13th Dreamforce conference.

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.

Required knowledge

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.

To get the most out of the app, some experience with Javascript and HTML will be necessary, and if you know AngularJS that will also help (but isn’t required).

Getting started

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.

Free Authentication

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 bootconfig.json file.

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!

Signup for the Ionic Newsletter to get the latest news and updates!