docs(ospo): community health rollout v2 — README, agents.md, health files #1556
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| # Code of Conduct | ||
|
|
||
| This project follows the ownCloud Code of Conduct. | ||
|
|
||
| Please read the full Code of Conduct at: | ||
| **<https://owncloud.com/contribute/code-of-conduct/>** | ||
|
|
||
| By participating in this project, you agree to abide by its terms. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,39 +1,9 @@ | ||
| # Contributing | ||
|
|
||
| Thank you for your interest in contributing to this project! | ||
|
|
||
| Please read the full contributing guidelines at: | ||
| **<https://owncloud.com/contribute/>** | ||
|
|
||
| For development setup, coding standards, and pull request process, | ||
| see the README in this repository. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,73 +1,116 @@ | ||
| # ownCloud iOS App | ||
|
|
||
| <!-- OSPO-managed README | Generated: 2026-04-16 | v2 --> | ||
|
|
||
| [](LICENSE) [](https://kiteworks.com/opensource) | ||
|
|
||
| The official ownCloud iOS application, built entirely in Swift for iOS 16+. It provides seamless file sync and share functionality with native iPadOS support, multi-account management, drag-and-drop operations, certificate management, password manager integration, and deep integration with the iOS Files app for cross-app collaboration. | ||
|
|
||
| ## Getting Started | ||
|
|
||
| Follow the steps below to build the iOS app from source. | ||
|
|
||
| ### Prerequisites | ||
|
|
||
| - Xcode (latest stable) | ||
| - iOS 16+ deployment target | ||
| - CocoaPods or Swift Package Manager | ||
|
|
||
| ### Build | ||
|
|
||
| For detailed build instructions, see [SETUP.md](SETUP.md). | ||
|
|
||
| ```bash | ||
| # Clone with submodules (includes ios-sdk) | ||
| git clone --recursive https://github.com/owncloud/ios-app.git | ||
| ``` | ||
|
|
||
| ## Documentation | ||
|
|
||
| - [iOS App Documentation](https://doc.owncloud.com/ios-app/) | ||
| - [Build Setup Guide](SETUP.md) | ||
| - [Docs & Guides](https://owncloud.com/docs-guides/) | ||
| - [Translations on Transifex](https://www.transifex.com/owncloud/) | ||
|
|
||
| ## Part of the ownCloud Mobile Ecosystem | ||
|
|
||
| This is the native iOS client for [ownCloud](https://owncloud.com). It connects to both ownCloud Infinite Scale (oCIS) and ownCloud Server 10 instances. | ||
|
|
||
| Available as a free download on the [App Store](https://apps.apple.com/app/id1359583808). | ||
|
|
||
| ## Community & Support | ||
|
|
||
| **[Star](https://github.com/owncloud/ios-app)** this repo and **Watch** for release notifications! | ||
|
|
||
| - [ownCloud Website](https://owncloud.com) | ||
| - [Community Discussions](https://github.com/orgs/owncloud/discussions) | ||
| - [Matrix Chat](https://app.element.io/#/room/#owncloud:matrix.org) | ||
| - [Documentation](https://doc.owncloud.com) | ||
| - [Enterprise Support](https://owncloud.com/contact-us/) | ||
| - [OSPO Home](https://kiteworks.com/opensource) | ||
|
|
||
| ## Contributing | ||
|
|
||
| We welcome contributions! Please read the [Contributing Guidelines](CONTRIBUTING.md) | ||
| and our [Code of Conduct](CODE_OF_CONDUCT.md) before getting started. | ||
|
|
||
| ### Workflow | ||
|
|
||
| - **Rebase Early, Rebase Often!** We use a rebase workflow. Always rebase on the target branch before submitting a PR. | ||
| - **Dependabot**: Automated dependency updates are managed via Dependabot. Review and merge dependency PRs promptly. | ||
| - **Signed Commits**: All commits **must** be PGP/GPG signed. See [GitHub's signing guide](https://docs.github.com/en/authentication/managing-commit-signature-verification). | ||
| - **DCO Sign-off**: Every commit must carry a `Signed-off-by` line: | ||
| ``` | ||
| git commit -s -S -m "your commit message" | ||
| ``` | ||
| - **GitHub Actions Policy**: Workflows may only use actions that are (a) owned by `owncloud`, (b) created by GitHub (`actions/*`), or (c) verified in the GitHub Marketplace. | ||
|
|
||
| ## Translations | ||
|
|
||
| Help translate this project on Transifex: | ||
| **<https://explore.transifex.com/owncloud-org/owncloud-ios/>** | ||
|
|
||
| Please submit translations via Transifex -- do not open pull requests for translation changes. | ||
|
|
||
| ## Security | ||
|
|
||
| **Do not open a public GitHub issue for security vulnerabilities.** | ||
|
|
||
| Report vulnerabilities at **<https://security.owncloud.com>** -- see [SECURITY.md](SECURITY.md). | ||
|
|
||
| Bug bounty: [YesWeHack ownCloud Program](https://yeswehack.com/programs/owncloud-bug-bounty-program) | ||
|
|
||
| ## License | ||
|
|
||
| This project is licensed under the [GPL-3.0](LICENSE). | ||
|
|
||
| ## About the ownCloud OSPO | ||
|
|
||
| The [Kiteworks Open Source Program Office](https://kiteworks.com/opensource), operating under | ||
| the [ownCloud](https://owncloud.com) brand, launched on May 5, 2026, to steward the open source | ||
| ecosystem around ownCloud's products. The OSPO ensures transparent governance, license compliance, | ||
| community health, and sustainable collaboration between the open source community and | ||
| [Kiteworks](https://www.kiteworks.com), which acquired ownCloud in 2023. | ||
|
|
||
| - **OSPO Home**: <https://kiteworks.com/opensource> | ||
| - **GitHub**: <https://github.com/owncloud> | ||
| - **ownCloud**: <https://owncloud.com> | ||
|
|
||
| For questions about the OSPO or licensing, contact ospo@kiteworks.com. | ||
|
|
||
| ### License Migration to Apache 2.0 | ||
|
|
||
| The OSPO is driving a strategic relicensing of ownCloud repositories toward the | ||
| [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0), following | ||
| the [Apache Software Foundation's third-party license policy](https://www.apache.org/legal/resolved.html). | ||
|
|
||
| Individual repositories will migrate as their audit is completed. The LICENSE file | ||
| in each repo reflects its **current** license status (not the target). | ||
|
|
||
| **Current license: GPL-3.0** (Category X per Apache policy -- cannot be included in Apache-2.0 works). | ||
|
|
||
| Migration prerequisites for this repository: | ||
|
|
||
| - **CLA/DCO coverage**: All past contributors must have signed agreements permitting relicensing | ||
| - **Copyleft dependency audit**: All GPL dependencies must be replaced or isolated | ||
| - **Complete relicensing**: GPL-3.0 is a strong copyleft license; migration requires full relicensing of all files |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,11 @@ | ||||||||||||||
| # Security Policy | ||||||||||||||
|
Author
There was a problem hiding this comment. Same REUSE 3.3 gap as
Suggested change
Generated by Claude Code |
||||||||||||||
|
|
||||||||||||||
| ## Reporting a Vulnerability | ||||||||||||||
|
|
||||||||||||||
| **Do NOT open a public GitHub issue for security vulnerabilities.** | ||||||||||||||
|
|
||||||||||||||
| Please report security issues responsibly via: | ||||||||||||||
| **<https://security.owncloud.com>** | ||||||||||||||
|
|
||||||||||||||
| You can also report vulnerabilities through our YesWeHack bug bounty program: | ||||||||||||||
| **<https://yeswehack.com/programs/owncloud-bug-bounty-program>** | ||||||||||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,49 +1,10 @@ | ||
| # Support | ||
|
|
||
| For support with this project, please use the following channels: | ||
|
|
||
| - **Enterprise Support**: <https://owncloud.com/contact-us/> | ||
| - **Community discussions**: https://github.com/orgs/owncloud/discussions | ||
| - **Matrix Chat**: <https://app.element.io/#/room/#owncloud:matrix.org> | ||
| - **Documentation**: <https://doc.owncloud.com> | ||
|
|
||
| Please do not use GitHub issues for general support questions. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,68 @@ | ||||||||||||||
| # agents.md -- ownCloud iOS App | ||||||||||||||
|
Author
There was a problem hiding this comment. Same REUSE 3.3 gap — new file, no SPDX header, no dep5/REUSE.toml coverage.
Suggested change
Generated by Claude Code |
||||||||||||||
|
|
||||||||||||||
| ## Repository Overview | ||||||||||||||
|
|
||||||||||||||
| The official ownCloud iOS client, written in Swift. Licensed under GPL-3.0, targeting iOS 16+. Uses the ios-sdk (included as a submodule) for all server communication. | ||||||||||||||
|
|
||||||||||||||
| ## Architecture & Key Paths | ||||||||||||||
|
|
||||||||||||||
| - `ownCloud/` -- Main app target | ||||||||||||||
| - `ownCloudAppFramework/` -- Shared framework code | ||||||||||||||
| - `ownCloudAppShared/` -- Shared utilities across extensions | ||||||||||||||
| - `ownCloud.xcodeproj/` -- Xcode project | ||||||||||||||
| - `ownCloud Action Extension/` -- iOS Action Extension | ||||||||||||||
| - `ownCloud File Provider/` -- iOS Files integration | ||||||||||||||
| - `ownCloud Share Extension/` -- Share Sheet extension | ||||||||||||||
| - `ownCloud Intents/` -- Siri/Shortcuts intents | ||||||||||||||
| - `ios-sdk/` -- Git submodule: ownCloud iOS SDK | ||||||||||||||
| - `fastlane/` -- Fastlane deployment configuration | ||||||||||||||
| - `doc/` -- Screenshots and documentation images | ||||||||||||||
| - `SETUP.md` -- Build instructions | ||||||||||||||
| - `CONTRIBUTING.md` -- Contribution guidelines | ||||||||||||||
| - `SUPPORT.md` -- Support resources | ||||||||||||||
|
|
||||||||||||||
| ## Development Conventions | ||||||||||||||
|
|
||||||||||||||
| - Swift codebase targeting iOS 16+ | ||||||||||||||
| - Xcode as the primary build system | ||||||||||||||
| - Fastlane for CI/CD and App Store deployment | ||||||||||||||
| - Translations via Transifex | ||||||||||||||
|
|
||||||||||||||
| ## Build & Test Commands | ||||||||||||||
|
|
||||||||||||||
| ```bash | ||||||||||||||
| # Build instructions are in SETUP.md | ||||||||||||||
| # Clone with submodules: | ||||||||||||||
| git clone --recursive https://github.com/owncloud/ios-app.git | ||||||||||||||
| # Open ownCloud.xcodeproj in Xcode and build | ||||||||||||||
| ``` | ||||||||||||||
|
|
||||||||||||||
| ## Important Constraints | ||||||||||||||
|
|
||||||||||||||
| - Licensed under GPL-3.0 (copyleft). Apache 2.0 migration requires resolving copyleft dependencies. | ||||||||||||||
| - The ios-sdk submodule is also GPL-3.0. | ||||||||||||||
| - All contributions require a DCO sign-off. | ||||||||||||||
| - The LICENSE file in the repository root is the authoritative license source. | ||||||||||||||
|
|
||||||||||||||
|
|
||||||||||||||
| ## OSPO Policy Constraints | ||||||||||||||
|
|
||||||||||||||
| ### GitHub Actions | ||||||||||||||
| - **Only** use actions owned by `owncloud`, created by GitHub (`actions/*`), verified on the GitHub Marketplace, or verified by the ownCloud Maintainers. | ||||||||||||||
| - Pin all actions to their full commit SHA (not tags): `uses: actions/checkout@<SHA> # vX.Y.Z` | ||||||||||||||
| - Never introduce actions from unverified third parties. | ||||||||||||||
|
|
||||||||||||||
| ### Dependency Management | ||||||||||||||
| - Dependabot is configured for automated dependency updates. | ||||||||||||||
| - Review and merge Dependabot PRs as part of regular maintenance. | ||||||||||||||
| - Do not introduce new dependencies without discussion in an issue first. | ||||||||||||||
|
|
||||||||||||||
| ### Git Workflow | ||||||||||||||
| - **Rebase policy**: Always rebase; never create merge commits. Use `git pull --rebase` and `git rebase` before pushing. | ||||||||||||||
| - **Signed commits**: All commits **must** be PGP/GPG signed (`git commit -S -s`). | ||||||||||||||
| - **DCO sign-off**: Every commit needs a `Signed-off-by` line (`git commit -s`). | ||||||||||||||
| - **Conventional Commits & Squash Merge**: Use the [Conventional Commits](https://www.conventionalcommits.org/) format where the repository enforces it. Many repos use squash merge, where the PR title becomes the commit message on the default branch — apply Conventional Commits format to PR titles as well. A reusable GitHub Actions workflow enforces this. | ||||||||||||||
|
|
||||||||||||||
| ## Context for AI Agents | ||||||||||||||
|
|
||||||||||||||
| This is a native iOS app built with Swift and UIKit. The app uses a modular architecture with separate extensions for Files, Share Sheet, and Intents. The ios-sdk submodule handles all server API communication. Any changes should be made using Xcode-compatible project settings. | ||||||||||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
REUSE 3.3: this new file has no SPDX license/copyright header, and the repo has no
.reuse/dep5/REUSE.tomlcovering docs by path. Suggest an SPDX header so this file has explicit REUSE coverage.Generated by Claude Code