Contributing to the App development

First off all, thank you for taking the time to contribute!

The App is free and open source and built by people on their spare time, so please don’t expect people to be as into your situation as you are. The best way to contribute is to code yourself, so please read This excellent guide

Before submitting a bug, feature request or pull request

• Have you actually read the error message?
• Have you searched for similar issues?
• Have you updated homey, all apps, and the development tools (if applicable)?
• Have you checked that it’s not a problem with one of the devices you’re using, rather than the App itself?
• Have you looked at what’s involved in fixing/implementing this?

Capable programmers should always attempt to investigate and fix problems themselves before asking for others to help. Submit a pull request instead of an issue!

A great bug report contains

• Context – what were you trying to achieve?
• Detailed steps to reproduce the error from scratch. Try isolating the minimal amount of code needed to reproduce the error.
• Any applicable log files or ID’s.
• Evidence you’ve looked into solving the problem and ideally, a theory on the cause and a possible solution.

A great feature request contains

• The current situation.
• How and why the current situation is problematic.
• A detailed proposal or pull request that demonstrates how the problem could be solved.
• A use case – who needs this feature and why?
• Any caveats.

A great pull request contains

• Minimal changes. Only submit code relevant to the current issue. Other changes should go in new pull requests.
• Minimal commits. Please squash to a single commit before sending your pull request.
• No conflicts. Please rebase off the latest master before submitting.
• Code conforming to the existing conventions and formats. i.e. Please don’t reformat whitespace.
• Passing tests in the test folder (if applicable). Use existing tests as a reference.
• Relevant documentation.