Local Debugging

No command-line tools need to be installed. Local debugging takes only two steps: integrate the SDK, then open the online DevTool in your browser to load your local service.

1. Integrate the Platform SDK

Include this in your app page:

<script src="https://static-res.atomm.com/scripts/js/generator-sdk/platform-sdk.js"></script>

Once loaded, the SDK handshakes with the platform and injects a global atomm object (see atomm object).

2. Open the Online DevTool Preview

After starting your service locally (any port), open the URL below in your browser and fill your local address into ?local= (only loopback addresses such as localhost / 127.0.0.1 are supported):

https://www.atomm.com/creativetools/community/generator/<generator-name>?local=http://localhost:5173/
www.atomm.com/…/generator/my-tool?local=localhost:5173
Your Generator · Live Preview
Integration Assistant
SDK connected
Export ready
atomm object ready
  • Left: a live preview of your generator (your local service runs in the same environment it will run in live, with the same capability limits)
  • Right: the integration assistant panel:
    • SDK integration hint: shows an "integration incomplete" notice until platform-sdk.js is loaded, along with copyable integration code and a documentation link; it disappears automatically once the SDK handshake succeeds.
    • Platform capability list: lists the capabilities the platform provides (export / download, the atomm object, etc.); each item lets you "view docs" or "copy the integration prompt" to hand off to an AI for integration.

Dev preview mode is fixed to the dev environment, incurs no charges, has all platform capabilities enabled by default, and does not depend on any backend data.

You can also open it directly from the console

On the app detail page in the Developer Console, fill in your local address in the "Local Debugging" card to open the preview above directly.

About HTTP and mixed content

www.atomm.com runs over HTTPS. Browsers grant a mixed-content exemption for http addresses on localhost, so a local http service loads normally; non-localhost http addresses will be blocked by the browser — use localhost or enable HTTPS for your local service.

Esc
Search all docs · to navigate · to open