Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-staging.skybridge.tech/llms.txt

Use this file to discover all available pages before exploring further.

The useRequestSize hook returns a function that asks the host to update the iframe height and/or width. Use it to deliberately pin a size. 
import { useEffect, useState } from "react";
import { useRequestSize } from "skybridge/web";

function Expandable() {
  const requestSize = useRequestSize();
  const [expanded, setExpanded] = useState(false);

  useEffect(() => {
    requestSize({ height: expanded ? 500 : undefined });
  }, [expanded, requestSize]);

  return (
    <div>
      <button onClick={() => setExpanded((v) => !v)}>
        {expanded ? "Collapse" : "Expand"}
      </button>
      {expanded && <p>Lots of additional content...</p>}
    </div>
  );
}

​
Returns

requestSize: (size: { width?: number; height?: number }) => Promise<void>
An async function that asks the host to size your view’s container to the given dimensions. Both width and height are optional; pass only what you want to update.

​
Runtime behavior

RuntimeBehavior
Apps SDK (ChatGPT)Not supported
MCP AppsSends ui/notifications/size-changed with both width and height to the host.
The host may clamp the requested size or ignore it entirely in display modes that own the viewport.