https://github.com/smartthingscommunity/smartapp-example-every-setting-nodejs

This SmartApp has multiple configuration pages that contain examples of all setting types.
https://github.com/smartthingscommunity/smartapp-example-every-setting-nodejs

smartthings-smartapp-example webhook

Last synced: 12 months ago
JSON representation

This SmartApp has multiple configuration pages that contain examples of all setting types.

• Host: GitHub
• URL: https://github.com/smartthingscommunity/smartapp-example-every-setting-nodejs
• Owner: SmartThingsCommunity
• License: apache-2.0
• Created: 2020-12-03T20:51:04.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2022-10-17T18:02:32.000Z (over 3 years ago)
• Last Synced: 2025-03-26T02:42:38.741Z (12 months ago)
• Topics: smartthings-smartapp-example, webhook
• Language: JavaScript
• Homepage:
• Size: 132 KB
• Stars: 4
• Watchers: 8
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Every Setting Example

This SmartApp has multiple configuration pages that contain examples of all

[setting types](https://github.com/SmartThingsCommunity/smartapp-sdk-nodejs/blob/main/docs/classes/_pages_section_d_.section.md).

## Start

To get going quickly with this example, we've provided a few options for hosting below. Follow any one of them to get the app up and accepting requests before moving on to registration instructions.

### Heroku

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)

[View logs](https://devcenter.heroku.com/articles/logging#log-retrieval-via-the-web-dashboard) in the Heroku dashboard.

Click the **Open app** button in the Heroku dashboard app page to copy the public URL for use in steps below.

### Glitch (no account required)

[![Remix on Glitch](https://cdn.glitch.com/2703baf2-b643-4da7-ab91-7ee2a2d00b5b%2Fremix-button.svg)](https://glitch.com/edit/#!/import/github/SmartThingsCommunity/smartapp-example-every-setting-nodejs)

[View logs](https://support.glitch.com/t/console-log-where-to-find-it/14456) in the Glitch editor.

Copy the [Live Site URL](https://glitch.happyfox.com/kb/article/50-how-do-i-find-the-url-for-my-app/) from Glitch for use in steps below.

### Local

We recommend using [ngrok](https://ngrok.com/) to create a globally available URL for fast testing.

`npm install`

`npm start`

`ngrok http 3001`

## Register

Follow the instructions for [registering a SmartApp](https://smartthings.developer.samsung.com/docs/smartapps/app-registration.html) with the SmartThings platform.

- The following OAuth2 scopes are required.

    - `r:devices:*`

    - `r:locations:*`

    - `r:scenes:*`

A `CONFIRMATION request` log should show in the log output of the server once registered. Navigate to this link to [verify your domain ownership](https://smartthings.developer.samsung.com/docs/smartapps/webhook-apps.html#Verify-your-domain-ownership) and enable the app to receive events. **This is required for successful installation.**

## Test

Follow the instructions for [testing a SmartApp](https://smartthings.developer.samsung.com/docs/testing/how-to-test.html).

## File Structure

* smartapp.js — the SmartApp implementation

* server.js — the Express server that hosts the SmartApp as a webhook

* locales/en.json — English version of the app configuration page text