Create Homey App

This app is still under development

Create Homey-App without build configuration. In a single command, this tool bootstraps an app with associated version management and a dockerized remote development environments.

"Old" apps can also be upgraded, if the command is called in the existing app-root directory.

- Creating an App
- Homey Apps SDK v3

Create Homey App works on macOS, Windows, and Linux.\
If something doesn’t work, please file an issue.\
If you have questions or need help, please ask in Homey Community Forum.

----

Requirements

- Visual Studio Code
- Remote - Containers extension
- Docker
- Git
- Node.js

----

Quick Overview

``sh
npx create-homey-app [my-app]
cd my-app
code .
`

If you've previously installed Homey Command-line interface globally via npm i -g homey, we recommend you uninstall the package using npm uninstall -g homey or yarn global remove homey to ensure that npx always uses the latest version.

_(npx comes with npm 5.2+ and higher, see instructions for older npm versions)_

----

Note

This is my second attempt to normalize and simplify the structure of my homey app development environment with VSCode.

----

Creating or update an Homey-App

$3

`sh


Invoking from the npm registery

npx create-homey-app [my-app]

Invoking from the github repository

npx github:cghome/create-homey-app [my-app]
`

$3

`sh
npm init homey-app [my-app]
`

_npm init is available in npm 6+_

$3

`sh
yarn create homey-app [my-app]
`

It will create a directory called my-app inside the current folder.

Inside that directory, it will generate the initial project structure and install the transitive dependencies:

----

Add on's

$3

Add to app.js

`js
/**
* homey-debugger
*/

/ eslint-disable /
if (process.env.DEBUG === "1") {
require("inspector").open(9229, "0.0.0.0", false);
// require("inspector").open(9229, "0.0.0.0", true);
}
/ eslint-enable /
`

----

What's included

$3

- test - homey app run
- start - npm install && homey app install
- build - homey app build
- publish - homey app publish
- postpublish - npm run init && git commit --amend --no-edit ./package.json && git push -f origin main
- validate - homey app validate -l publish
- validateTest - homey app validate
- init - npm init --quiet -y 1>/dev/null
- lint - eslint .
- createRemoteRepo - hub create -d "$npm_package_description" -h $npm_package_homepage ${PWD##*/} && git commit --amend --no-edit && git push -u origin main

----

For Developers

$3

`sh
git clone https://github.com/cgHome/create-homey-app.git

cd create-homey-app
npm link
code .

happy coding

Test app > use JavaScript Debug Terminal


create-homey-app [my-app]
``

$3

- Developing inside a Container
- Dockerisieren Sie Ihre Entwicklungsumgebung in VS Code

$3

- VS Code - Remote Development
- VS Code - Contributing
- VS Code - Scripts:

$3

- see:
- see:
- see:

----

Changelog

v0.1.0

- Initial commit

----

ToDo

- Add Screencast
- Add localHomey - Parameter
- Remove createRemoteRepo npm-script if the remote repository exists

----

Copyright

Copyright 2021, 2021 [Chris Gross] cFlat-inc.org