Gobo App Example

A simple example application to demonstrate how to build a Gobo-compliant third-party app.

See the docs for more information.

Dependencies

• Node.js v22

Installation

$ cp .env.example .env
$ npm install

Configuration

Update the Environment Variables in .env:

• Get APP_CLIENT_SECRET from your developer portal.
• Set APP_MARKETPLACE_URL to https://<YOUR_TENANT_SLUG>.withgobo.com or https://<YOUR_CUSTOM_MARKETPLACE_DOMAIN>.
• Set API_URL to the API endpoint that you want to test.
• Set SECRET_KEY to a cryptographically secure random string of at least 32 characters.

Get a secure URL for this application by deploying it to the Internet or exposing it using a service like ngrok. Then in the Gobo developer portal:

• Set your app's install URL to: <HOSTED_APP_URL>/install
• Set your app's OAuth redirect URL to: <HOSTED_APP_URL>/callback

Run the App

$ npm start

Local Development

$ npm run dev