Skip to content

HabitRPG/habitica-ios

Folders and files

NameName
Last commit message
Last commit date

Latest commit

fe091da · Mar 24, 2025
Apr 22, 2024
Mar 24, 2025
Mar 19, 2025
Jan 22, 2025
Jan 27, 2025
Jan 27, 2025
Mar 24, 2025
Aug 22, 2022
Jan 27, 2025
Dec 11, 2023
Jan 27, 2025
Mar 19, 2025
Jan 15, 2025
Jan 27, 2025
Oct 27, 2020
Jan 22, 2025
Aug 31, 2021
Apr 8, 2022
Mar 10, 2016
Mar 19, 2017
May 21, 2024
Feb 7, 2023
Nov 30, 2020
Mar 14, 2022
Jun 11, 2024
Nov 2, 2021
Oct 8, 2020
Mar 17, 2022
Feb 7, 2015
Feb 18, 2016
Jun 18, 2024
Jun 14, 2021
Mar 14, 2022
Apr 5, 2022
Jul 10, 2018
Mar 25, 2021
Sep 19, 2015
Dec 20, 2021
Dec 20, 2021

Repository files navigation

Habitica for iOS

Native iOS app for Habitica.

Contributing

Thank you very much to all contributors.

How mobile releases work

All major mobile releases are organized by Milestones labeled with the release number. The 'Help Wanted' is added to any issue we feel would be okay for a contributor to work on, so look for that tag first! We do our best to answer any questions contributors may have regarding issues marked with that tag. If an issue does not have the 'Help Wanted' tag, that means staff will handle it when we have the availability.

The mobile team consists of one developer and one designer for both Android and iOS. Because of this, we switch back and forth for releases. While we work on one platform, the other will be put on hold. This may result in a wait time for PRs to be reviewed or questions to be answered. Any PRs submitted while we're working on a different platform will be assigned to the next Milestone and we will review it when we come back!

Given that our team is stretched pretty thin, it can be difficult for us to take an active role in helping to troubleshoot how to fix issues, but we always do our best to help as much as possible :) With this in mind, when selecting issues to work on it may be best to pick up issues you already have a good idea how to handle and test. Thank you for putting in your time to help make Habitica the best it can be!

Steps for contributing to this repository:

  1. Fork it
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Create new Pull Request
  • Don't forget to include your Habitica User ID, so that we can count your contributrion towards your contributor tier

Setup for local development

Config File

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.

Install swiftgen and generate secrets

brew install swiftgen

# Replace the secrets.yml.example to secrets.yml and set your own values

swiftgen config run

NOTE You can run the project without being set the credentials but this features will be limited