I’ve managed to install the repository, run the npm start command and get the tunnel URL. If I visit the URL via the browser, I can see the “Hello Monday App” message.
I’m also able to copy/paste the same URL in the “Custom URL” of the app settings (and select the Boards), and if I click on “Go to Preview” I see the “Hello Monday App” message.
Then I publish the app and install it, but nothing is happening on monday.com when I try to use it. What I’ve noticed is that, in the app settings, if I go back to the main view and then I click again on “Features” to edit the board view, when I visit the “view setup” tab the “custom url” is gone and there is no way to permanently save it; I can copy/paste again the tunnel URL and click on “go to preview” and it works, but still there is no way to save the changes.
Since you’re seeing the “Hello Monday App” banner, that means the quickstart-react app is running correctly.
Here’s a quick overview of how monday apps work:
Every app must be hosted somewhere and loaded in an iframe inside a monday view to access the SDK (which allows communication with monday.com).
During development, the app is usually hosted locally on your machine. To make it accessible from the internet (so monday can load it in the iframe), a tunnel is used. This tunnel links your local machine to a public URL.
However, this setup is only suitable for development, as it requires your machine and the tunnel to be running continuously—which isn’t ideal.
Once you finish development, you’ll need to deploy your app to a proper hosting service (such as monday code or another provider).
If you want to use tunnel, make sure your tunnel link is correctly set in the feature deployment settings, and that the tunnel is active. (recommended for fast dev)