Clearly separate sunpeak and MCP App API documentation

Author: abewheel

CLAUDE.md

@@ -154,7 +154,16 @@ Docs are built with [Mintlify](https://mintlify.com). Structure:
 - **`docs/mcp-apps/`** — MCP Apps SDK documentation (protocol-level, not sunpeak-specific). Badge: `<Badge color="green">MCP Apps SDK</Badge>`.
 - **`docs/mcp-apps/types/protocol-reference.mdx`** — Complete protocol type/schema reference.
 
-When adding new hooks or features, you must: create the hook doc page, add it to `docs.json` navigation (alphabetical within its group), and update cross-references (e.g., the `<Note>` in `mcp-apps/app/requests.mdx` that lists convenience hooks).
+When adding new hooks or features, you must: create the hook doc page, add it to `docs.json` navigation (alphabetical within its group), and update cross-references (e.g., the `<Tip>` in `mcp-apps/app/requests.mdx` that lists convenience hooks).
+
+### Places to Update When User-Facing Functionality Changes
+
+When sunpeak package APIs change (new hooks, new features, deprecations, etc.), these locations may need updating:
+
+1. **`docs/`** — Mintlify docs pages (hook docs, MCP Apps SDK docs, cross-references)
+2. **READMEs** — `README.md` files throughout the monorepo (`packages/sunpeak/README.md`, root `README.md`, template `README.md`)
+3. **`skills/create-sunpeak-app/SKILL.md`** — Agent skill reference with hook tables, code examples, and usage patterns
+4. **Marketing website** — Separate repository (`../sunpeak-website/` or similar) with feature descriptions and code samples
 
 ## Upgrading Dependencies
 

docs/api-reference/hooks/use-app.mdx

@@ -75,3 +75,5 @@ import { AppProvider } from 'sunpeak';
 <ResponseField name="onAppCreated" type="(app: App) => void">
   Callback invoked when a new App instance is created. Optional.
 </ResponseField>
+
+See the [`App` class documentation](/mcp-apps/app/app-class) for the full API available on the `App` instance.

docs/api-reference/hooks/use-host-info.mdx

@@ -83,3 +83,5 @@ function MyResource() {
   );
 }
 ```
+
+See [`McpUiHostCapabilities`](/mcp-apps/types/core-types#mcpuihostcapabilities) for the full protocol-level capabilities type.

docs/api-reference/hooks/use-locale.mdx

@@ -40,3 +40,5 @@ function MyResource() {
   return <p>{formatted}</p>;
 }
 ```
+
+The locale value comes from [`McpUiHostContext.locale`](/mcp-apps/types/core-types#mcpuihostcontext).

docs/api-reference/hooks/use-open-link.mdx

@@ -49,3 +49,5 @@ function MyResource() {
   );
 }
 ```
+
+Wraps the SDK's [`openLink()`](/mcp-apps/app/requests#openlink) method.

docs/api-reference/hooks/use-safe-area.mdx

@@ -54,3 +54,5 @@ function MyResource() {
   );
 }
 ```
+
+Safe area insets come from [`McpUiHostContext.safeAreaInsets`](/mcp-apps/types/core-types#mcpuihostcontext).

docs/api-reference/hooks/use-send-log.mdx

@@ -57,3 +57,5 @@ function MyResource() {
   return <button onClick={handleAction}>Click Me</button>;
 }
 ```
+
+Wraps the SDK's [`sendLog()`](/mcp-apps/app/requests#sendlog) method.

docs/api-reference/hooks/use-viewport.mdx

@@ -55,3 +55,5 @@ function MyResource() {
   );
 }
 ```
+
+Container dimensions come from [`McpUiHostContext.containerDimensions`](/mcp-apps/types/core-types#mcpuihostcontext).

docs/docs.json

@@ -154,8 +154,8 @@
             "group": "Server API",
             "pages": [
               "mcp-apps/server/register-app-tool",
-              "mcp-apps/server/tool-meta",
               "mcp-apps/server/register-app-resource",
+              "mcp-apps/server/tool-meta",
               "mcp-apps/server/resource-meta",
               "mcp-apps/server/capability-detection"
             ]

docs/mcp-apps/app/app-class.mdx

@@ -8,13 +8,9 @@ keywords: ["MCP Apps", "ChatGPT Apps", "App class", "PostMessageTransport", "hos
 <Badge color="green">MCP Apps SDK</Badge>
 
 ```ts
-import { App, PostMessageTransport } from "sunpeak";
+import { App, PostMessageTransport } from "@modelcontextprotocol/ext-apps";
 ```
 
-<Note>
-In sunpeak, the [`useApp`](/mcp-apps/react/use-app) hook handles `App` creation and connection automatically. The details below are useful for understanding the underlying API or for non-React usage.
-</Note>
-
 ## Overview
 
 The `App` class provides a framework-agnostic way to build interactive MCP Apps that run inside host applications. It extends the MCP SDK's `Protocol` class and handles the connection lifecycle, [initialization handshake](/mcp-apps/lifecycle#2-initialization), and bidirectional communication with the host.
@@ -114,7 +110,7 @@ if (ctx?.theme === "dark") {
 The transport layer for iframe-to-parent communication using `window.postMessage`. In most cases you never need to use this directly — `App.connect()` creates one automatically when no transport is provided.
 
 ```ts
-import { PostMessageTransport } from "sunpeak";
+import { PostMessageTransport } from "@modelcontextprotocol/ext-apps";
 
 new PostMessageTransport(eventTarget?, eventSource)
 ```
@@ -149,3 +145,7 @@ Manually notify the host of a size change:
 ```ts
 app.sendSizeChanged({ width: 400, height: 600 });
 ```
+
+<Tip>
+In React, the SDK's [`useApp`](/mcp-apps/react/use-app) hook handles App creation and connection automatically. The [sunpeak framework](/quickstart) provides additional convenience hooks like [`useApp`](/api-reference/hooks/use-app).
+</Tip>