# Create-homey-app - Create Homey-App without build configuration

**URL:** <https://community.homey.app/t/create-homey-app-create-homey-app-without-build-configuration/43060>\
**Category:** Developers\
**Tags:** tools\
**Created:** [February 15, 2021, 7:54pm UTC](https://community.homey.app/t/create-homey-app-create-homey-app-without-build-configuration/43060 "2021-02-15T19:54:22Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![ChrisG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/chrisg/32/8825_2.png) [@ChrisG](https://community.homey.app/u/ChrisG)\
**Post date:** [February 15, 2021, 7:54pm UTC](https://community.homey.app/t/create-homey-app-create-homey-app-without-build-configuration/43060/1 "2021-02-15T19:54:22Z")

</div>

> **[cgHome/create-homey-app](https://github.com/cgHome/create-homey-app)**
>
> Create Homey-App without build configuration. Contribute to cgHome/create-homey-app development by creating an account on GitHub.

---

<div class="post-metadata">

**Author:** ![ChrisG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/chrisg/32/8825_2.png) [@ChrisG](https://community.homey.app/u/ChrisG)\
**Post date:** [February 15, 2021, 7:54pm UTC](https://community.homey.app/t/create-homey-app-create-homey-app-without-build-configuration/43060/2 "2021-02-15T19:54:56Z")

</div>

# 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](https://github.com/cgHome/create-homey-app#creating-or-update-an-homey-app)

- [Homey Apps SDK v3](https://apps-sdk-v3.developer.athom.com/)

Create Homey App works on macOS, Windows, and Linux.\

If something doesn’t work, please file an [issue](https://github.com/cgHome/create-homey-app/issues).\

If you have questions or need help, please ask in [Homey Community Forum](https://community.homey.app/t/create-homey-app-create-homey-app-without-build-configuration/43060).

* * *

## Requirements

- [Visual Studio Code](https://code.visualstudio.com/)

- [Remote - Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)

- [Docker](https://www.docker.com/)

- [Git](https://git-scm.com/)

- [Node.js](https://nodejs.org/en/)

* * *

## Quick Overview

```auto

npx create-homey-app [my-app]

cd my-app

code .

```

If you’ve previously installed [Homey Command-line interface](https://www.npmjs.com/package/homey) 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](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b) comes with npm 5.2+ and higher, see [instructions for older npm versions](https://gist.github.com/gaearon/4064d3c23a77c74a3614c498a8bb1c5f))_

* * *

## 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

### npx

```auto

# Invoking from the npm registery

npx create-homey-app [my-app]

# Invoking from the github repository

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

```

### npm

```auto

npm init homey-app [my-app]

```

_`npm init <initializer>` is available in npm 6+_

### Yarn

```auto

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

### Homey debugger

Add to app.js

```auto

/**

* 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

### npm-scripts

- 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

### Install Create-Homey-App

```auto

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]

```

### Tutorials

- [Developing inside a Container](https://code.visualstudio.com/docs/remote/containers)

- [Dockerisieren Sie Ihre Entwicklungsumgebung in VS Code](https://ichi.pro/de/post/234589651404201)

### Development Container Tips & Tricks

- [VS Code - Remote Development](https://github.com/microsoft/vscode-dev-containers/tree/master)

- [VS Code - Contributing](https://github.com/microsoft/vscode-dev-containers/blob/master/CONTRIBUTING.md)

- [VS Code - Scripts:](https://github.com/microsoft/vscode-dev-containers/tree/master/script-library)

### Create apps

- see: [https://medium.com/northcoders/creating-a-project-generator-with-node-29e13b3cd309](https://medium.com/northcoders/creating-a-project-generator-with-node-29e13b3cd309)

- see: [https://www.twilio.com/blog/how-to-build-a-cli-with-node-js](https://www.twilio.com/blog/how-to-build-a-cli-with-node-js)

- see: [https://github.com/sindresorhus/np](https://github.com/sindresorhus/np)

* * *

## Changelog

v0.1.0

- Initial commit

* * *

## ToDo

- Add Screencast

- Add localHomey - Parameter

* * *

## Copyright

Copyright 2021, 2021 [Chris Gross] [cFlat-inc.org](http://cFlat-inc.org)

---

<div class="post-metadata">

**Author:** ![ChrisG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/chrisg/32/8825_2.png) [@ChrisG](https://community.homey.app/u/ChrisG)\
**Post date:** [February 15, 2021, 7:55pm UTC](https://community.homey.app/t/create-homey-app-create-homey-app-without-build-configuration/43060/3 "2021-02-15T19:55:13Z")

</div>

For later use….
