Homey Apps SDK
📖 Apps SDK Reference🌍 Web API🛠 Developer Tools
  • Welcome to the Apps SDK documentation 👋
  • The Basics
    • Getting Started
      • Homey CLI
    • App
      • Manifest
      • Internationalization
      • Permissions
      • Persistent Storage
    • Drivers & Devices
      • Pairing
        • System Views
          • Devices List
          • Add Devices
          • OAuth2 Login
          • Credentials Login
          • Pincode
          • Loading
          • Done
        • Custom Views
      • Capabilities
      • Energy
      • Settings
      • Best practices
        • Lights
        • Window coverings
        • Battery status
    • Flow
      • Arguments
      • Tokens
    • Widgets
      • Settings
      • Styling
      • Debugging
  • Wireless
    • Wi-Fi
      • Discovery
    • Bluetooth LE
    • Z-Wave
    • Zigbee
    • 433 MHz
    • Infrared
    • Matter
  • Cloud
    • OAuth2
    • Webhooks
  • App Store
    • Publishing
    • Guidelines
    • Verified Developer
    • Updating
  • Advanced
    • Custom Views
      • App Settings
      • Custom Pairing Views
      • HTML & CSS Styling
    • Web API
    • Images
    • LED Ring
    • Homey Compose
  • Guides
    • Homey Cloud
    • Breaking Changes
    • Tools
      • Bluetooth LE
      • Zigbee
      • TypeScript
    • Using ESM in Homey Apps
  • Upgrade Guides
    • Homey v6.0.0
    • Upgrading to SDK v3
      • Zigbee Apps
    • Device Capabilities
Powered by GitBook
On this page
  • How to publish?
  • Requirements
  • Visibility
  • Automating within GitHub Actions

Was this helpful?

  1. App Store

Publishing

Publishing your app in the Homey App Store allows you to share it with other Homey users.

PreviousWebhooksNextGuidelines

Last updated 9 months ago

Was this helpful?

How to publish?

Publishing is as easy as running the following command from your app directory:

homey app publish

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.

Requirements

To check if all requirements are met, validate your app prior to submission.

homey app validate --level publish

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.

homey app validate --level verified

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.

Visibility

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!

Automating within GitHub Actions

To automate the validation, versioning and publishing of your Homey app within GitHub Actions, you can use the following Actions from the GitHub Marketplace.

Before you publish your app make sure to read the . 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 , 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.

To get an idea of which type of apps are displayed check out the page.

App Store Guidelines
https://tools.developer.homey.app
App Store overview
https://github.com/marketplace/actions/homey-app-validate
https://github.com/marketplace/actions/homey-app-update-version
https://github.com/marketplace/actions/homey-app-publish