Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/HabitRPG/habitica-ios
Native iOS app for Habitica
https://github.com/HabitRPG/habitica-ios
cocoapods habitica hacktoberfest ios objective-c realm swift
Last synced: 30 days ago
JSON representation
Native iOS app for Habitica
- Host: GitHub
- URL: https://github.com/HabitRPG/habitica-ios
- Owner: HabitRPG
- License: gpl-3.0
- Created: 2015-02-20T17:27:49.000Z (almost 10 years ago)
- Default Branch: develop
- Last Pushed: 2024-04-22T13:18:59.000Z (8 months ago)
- Last Synced: 2024-04-22T13:52:21.770Z (8 months ago)
- Topics: cocoapods, habitica, hacktoberfest, ios, objective-c, realm, swift
- Language: Swift
- Homepage:
- Size: 106 MB
- Stars: 657
- Watchers: 32
- Forks: 220
- Open Issues: 96
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-open-source-ios-apps - Habitica
README
# Habitica for iOS
Native iOS app for [Habitica](https://habitica.com/).
## Contributing
Thank you very much [to all contributors](https://github.com/HabitRPG/habitica-ios/graphs/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