# [Nextcloud](https://nextcloud.com) iOS app [![Releases](https://img.shields.io/github/release/nextcloud/ios.svg)](https://github.com/nextcloud/ios/releases/latest) [![Build](https://github.com/nextcloud/ios/actions/workflows/xcode.yml/badge.svg)](https://github.com/nextcloud/ios/actions/workflows/xcode.yml) [![SwiftLint](https://github.com/nextcloud/ios/actions/workflows/lint.yml/badge.svg)](https://github.com/nextcloud/ios/actions/workflows/lint.yml) [![irc](https://img.shields.io/badge/IRC-%23nextcloud--mobile%20on%20freenode-blue.svg)](https://webchat.freenode.net/?channels=nextcloud-mobile) Demo of the Nextcloud iOS files app [Demo of the Nextcloud iOS files app](https://itunes.apple.com/us/app/nextcloud/id1125420102) Check out https://nextcloud.com and follow us on [twitter.com/nextclouders](https://twitter.com/nextclouders) or [twitter.com/NextcloudiOS](https://twitter.com/NextcloudiOS) ## How to contribute If you want to [contribute](https://nextcloud.com/contribute/) to Nextcloud, you are very welcome: - on our IRC channels [![irc](https://img.shields.io/badge/IRC-%23nextcloud%20on%20freenode-orange.svg)](https://webchat.freenode.net/?channels=nextcloud) and [![irc](https://img.shields.io/badge/IRC-%23nextcloud--mobile%20on%20freenode-blue.svg)](https://webchat.freenode.net/?channels=nextcloud-mobile) on freenode - our forum at https://help.nextcloud.com/c/clients/ios - for translations of the app on [Transifex](https://www.transifex.com/nextcloud/nextcloud/dashboard/) - opening issues and PRs (including a corresponding issue) ## Contribution Guidelines & License [GPLv3](LICENSE.txt) with [Apple app store exception](COPYING.iOS). Nextcloud doesn't require a CLA (Contributor License Agreement). The copyright belongs to all the individual contributors. Therefore we recommend that every contributor adds following line to the header of a file, if they changed it substantially: ``` @copyright Copyright (c) , () ``` Please read the [Code of Conduct](https://nextcloud.com/code-of-conduct/). This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere, and to explain how together we can strengthen and support each other. More information how to contribute: [https://nextcloud.com/contribute/](https://nextcloud.com/contribute/) ## Start contributing You can start by forking this repository and creating pull requests on the develop branch. Maybe start working on [starter issues](https://github.com/nextcloud/ios/labels/good%20first%20issue). Easy starting points are also reviewing [pull requests](https://github.com/nextcloud/ios/pulls) ### Xcode 13 Project Setup #### Dependencies After forking a repository you have to build the dependencies. Dependencies are managed with Carthage version 0.37.0 or later. Run ``` carthage update --use-xcframeworks --platform iOS --cache-builds ``` to fetch and compile the dependencies. In order to build the project in Xcode you will also need a file `GoogleService-Info.plist` at the root of the repository which contains the Firebase configuration. For development work you can use a mock version found [here](https://github.com/firebase/quickstart-ios/blob/master/mock-GoogleService-Info.plist). ### Creating Pull requests #### DCO Signoff Nextcloud enforces the [Developer Certificate of Origin (DCO)](https://developercertificate.org/) on Pull Requests. It requires your commit messages to contain a Signed-off-by line with an email address that matches your GitHub account. ##### How to Sign off The DCO is a way for contributors to certify that they wrote or otherwise have the right to submit the code they are contributing by adding a Signed-off-by line to commit messages. ``` My Commit message Signed-off-by: Random Contributor ``` Git even has a `-s | --signoff` command line option to append this to your commit messages automatically. ## Support If you need assistance or want to ask a question about the iOS app, you are welcome to [ask for support](https://help.nextcloud.com/c/clients/ios) in our forums or the [IRC-Channel](https://webchat.freenode.net/?channels=nextcloud-mobile). If you have found a bug, feel free to [open a new Issue on GitHub](https://github.com/nextcloud/ios/issues). Keep in mind, that this repository only manages the iOS app. If you find bugs or have problems with the server/backend, you should ask the [Nextcloud server team](https://github.com/nextcloud/server) for help! ## TestFlight Do you want to try the latest version in development of Nextcloud iOS ? Simple, follow this simple step [Apple TestFlight](https://testflight.apple.com/join/GjNbfo2a)