DocsAPI ReferenceChangelogSupport
Capabilities

Windows

A window is your plugin's main surface: a panel-sized or full window that renders your HTML inside Atlas.

Declare a window

Set kind to window, host.launch to local-window, and point entryPoints.window at your HTML. mount sets the size, whether it resizes, and whether only one can be open at once.

"kind": "window",
"host": { "launch": "local-window" },
"entryPoints": { "window": "index.html" },
"mount": { "title": "My Tool", "width": 62, "height": 54, "resizable": true, "singleton": true }

Open and control them

atlas.plugin.openWindow(request) opens a window in your own package — it throws if the request names another plugin's id. atlas.window then controls that window and needs no permission, but only works inside a package window.

close()Close this window.
focus()Bring it to the front.
getBounds()Its current x, y, width, and height.
startDrag(point)Begin a drag from a { screenX, screenY } point. For chrome: "custom" windows that draw their own header.
setDockHeight(units)Resize a bottom-docked strip, in host units. The host clamps the range.
setSidecarOpen(open)Expand or collapse a side-docked panel.

One plugin can run a main window plus extra panels.