Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
127 lines (81 loc) · 3.36 KB

CONTRIBUTING.md

File metadata and controls

127 lines (81 loc) · 3.36 KB

Contributing to SUPLA iOS

Thank you for your interest in contributing to SUPLA iOS. This document describes the rules and guidelines for contributing code, documentation, and ideas to the project.

Table of contents

Contributor License Agreement (CLA)

This project requires acceptance of a Contributor License Agreement (CLA).

Before a pull request can be merged, the CLA must be accepted by the contributor.

Pull requests with an unaccepted CLA will be blocked automatically.

Project scope and goals

supla-ios is the official iOS application for the SUPLA smart home platform.

Key goals:

  • stable and predictable user experience,
  • clear and maintainable architecture,
  • performance, battery efficiency and system integration.
  • UI/UX consistency and feature parity with the SUPLA Android app.

The iOS app is a client of the SUPLA platform. Changes should not assume a specific Cloud deployment (official vs self-hosted).

Supported environments

  • Xcode (current stable version recommended)
  • iOS versions supported by the application

Build requirements and dependencies are defined in the project configuration (Xcode project, CocoaPods).

Reporting issues

Before opening an issue:

  1. Search existing issues (open and closed).
  2. Verify that you are using a recent app version.

When reporting a bug, please include:

  • app version (App Store version, build number, or commit),
  • device model and iOS version,
  • steps to reproduce,
  • expected vs actual behavior,
  • logs if available (sanitize secrets).

If the issue depends on the backend, specify whether you use:

  • the official SUPLA Cloud, or
  • a self-hosted instance.

Security-related issues must not be reported via public issues. See SECURITY.md.

Feature requests

Feature requests are welcome.

Please describe:

  • the problem you are trying to solve,
  • why existing functionality is insufficient,
  • any UI/UX expectations,
  • whether the change depends on SUPLA Cloud / API behavior.

Large changes should be discussed in an issue before implementation.

Development guidelines

  • Keep changes small and focused.
  • Follow existing app architecture and iOS best practices.
  • Maintain UX consistency with the existing application.
  • Be mindful of performance, battery usage and background behavior.
  • Avoid breaking compatibility without prior discussion.

Pull request process

  1. Fork the repository and create a feature branch.
  2. Make small, focused commits with clear commit messages.
  3. Ensure the application builds successfully.
  4. Open a pull request using the provided template.
  5. Ensure the CLA check passes.

Each pull request should:

  • address a single issue or feature,
  • include a clear description of the changes,
  • reference related issues if applicable.

Licensing

By contributing to this repository, you agree that your contributions will be licensed under the same license as the project.

Any third-party code must use a compatible license and be clearly documented.