Native iOS app for Habitica.
For an introduction to the technologies used and how the software is organized, refer to Contributing to Habitica - "Coders (Web & Mobile)" section.
Thank you very much to all contributors.
- Fork it
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Create new Pull Request
- Don't forget to include your Habitica User ID, so that we can count your contributrion towards your contributor tier
Copy over the sample debug config file.
$ cp sample.debug.xcconfig debug.xcconfig
If you want to run your app against a locally running version of Habitica, change CUSTOM_DOMAIN
to localhost:3000
or whatever port you have your local version configured to. Also set DISABLE_SSL
to true so that the url can be configured correctly.
We are using CocoaPods to manage dependencies.
If you have managed ruby environment (rbenv, rvm, etc.):
$ bundle install
$ bundle exec pod install
As an alternative, it is possible to install the dependendencies manually. Use sudo
if required to install gems (i.e. you are using the MacOS system ruby):
$ sudo gem install cocoapods:'>=1.2'
$ sudo gem install cocoapods-keys
$ pod install
During installation, cocoapods-keys will prompt for some of the keys used in the project. Use any random value for debugging, the real values are only required when uploading a final build to the app store.
CocoaPods requires that you open the Habitica.xcworkspace.
$ open Habitica.xcworkspace