Layouts

Layouts save and restore the entire desktop arrangement — window positions, sizes, and app states — allowing users to instantly recreate their workspace.

Layout Types

  • App Default Layout — default window position and size for a single app
  • Workspace Layout — saved workspace arrangement (rows, columns, tabs)
  • Global Layout — entire desktop state including all open windows and workspaces

Saving a Layout

Save global layout
await io.layouts.save({
  name: "My Trading Setup",
  type: "Global",
});

Restoring a Layout

Restore global layout
await io.layouts.restore("My Trading Setup");

Layout Persistence

Layouts can be stored locally on disk or remotely via io.Manager. The saveInLayoutproperty in app definitions controls what data is persisted per-app (URL, context, etc.).