Run your Iris App

🚧

Beta

This is a beta version and subject to change without notice. Pricing, terms, conditions and availability may change in the final version.

📘

This is intended for local testing on the developer machine.

If you need to share your Iris App with other parties, you will need to submit your app.

1. Use the NX command to serve the Iris App for local testing.

npx nx run [name-of-your-app]:serve

... wait for the text to say ... compiled successfully in ...

2. Open a browser

Using this url: https://new.manager.trackunit.com/iris-sdk-portal/main#runLocal.

You might need to login before it hits that page, use your developer credentials.

3. The screen for the developer portal called Iris App Developer Portal will appear.

4. From this screen, make sure to enable Local dev mode.

Local dev mode enables the manager (which is remotely hosted) to load the apps directly from your local development environment. It might take around 30 seconds to load the first time. This is also where you can turn off running in local dev mode.

📘

Troubleshooting Tips

If the app is stuck loading:

• Look at the console and ensure that it is not still "bundling". Wait for its completion.
• Try reloading the page.
• Try a different browser (Safari is not currently supported).
• Ensure that you aren't running multiple instances by accident and if so, shutdown the duplicate processes.