Publishing
Publishing your app in the Homey App Store allows you to share it with other Homey users.
Last updated
Publishing your app in the Homey App Store allows you to share it with other Homey users.
Last updated
Publishing is as easy as running the following command from your app directory:
Before you publish your app make sure to read the App Store Guidelines. This will ensure the app review process goes smoothly and your app won't be rejected.
Your app will be compressed and send to the Homey App Store for processing. Go to https://tools.developer.homey.app, tap Apps SDK and choose My Apps. All your apps are visible here, and you can publish your app to Test, or Live by submitting it for certification. Once your app is approved by a reviewer at Athom it can be published.
By default your app will be submitted as Draft. You can then choose to release a Test version of the app, only available for users who visit your app via the Test link (available in your dashboard). After some proper testing the app can be submitted for certification by Athom. After approval it will be published to the Homey App Store and becomes available to all Homey users.
Apps that have never been released to the Homey App Store, will need to be certified before becoming publicly available for other users. In case you want to publish a Test version of the app make sure to disable the "publish directly after approval" checkbox when submitting for certification.
To check if all requirements are met, validate your app prior to submission.
For Verified Homey Apps there are some additional requirements which can be validated with the verified
validation level. This level will be applied by default if you are logged in with a verified developer account.
Validation level
Description
debug
The debug validation level is used during development. Various app manifest properties, such as images
,brandColor
, andcategory
are optional at this validation level.
publish
You app needs to pass this validation level to be published to the Homey App store for Homey Pro.
verified
If you are a verified app developer your app needs to pass this validation level. This is required for Homey Cloud. The verified validation level adds additional requirements such as adding platforms
, connectivity
, and support
to your manifest.
The Homey App Store overview page shows various categories, in which apps are sorted. Only the best, most popular and visually appealing apps are shown here.
To get your app displayed on the Homey App Store overview page, make sure that your app not only works great but also looks amazing. So add a catchy Description, beautiful App Image, great Icon. Capture the attention of your users!
To get an idea of which type of apps are displayed check out the App Store overview page.
To automate the validation, versioning and publishing of your Homey app within GitHub Actions, you can use the following Actions from the GitHub Marketplace.