Using Doppio with local code

Using Doppio with local code can be tricky. If you use setContent, things stay simple because you send the HTML directly. But if you want to use goto or receive webhooks locally, your app must be reachable from the internet.

ngrok solves that problem. It is a small CLI tool that exposes your local development URL publicly so Doppio can access it during development.

Ngrok

To get started, download and install ngrok, create an account, and copy your authentication token from the ngrok dashboard. Then authenticate your local ngrok agent with:

ngrok config add-authtoken 4xxxyour-auth-tokenxxx

Use ngrok with your app

Start your local app as you normally would.

You only need to know which port your local app is listening on. For example, if your app runs on port 5173, start ngrok with:

ngrok http 5173

ngrok then gives you a public URL that you can use with Doppio. You can point goto to that URL, or use it as a webhook endpoint while testing locally.

Your app and ngrok must run at the same time. You may need a second terminal tab or window to keep both processes open.

Using ngrok is a simple way to test Doppio against a local application before deployment.