Contextual menu

Anatomy

Every docs page has a Copy page split button in the top-end corner of the header. The primary button copies the raw Markdown source. The chevron opens a dropdown organized into four sections:

Built-in items (14 total)

Content (4)

AI platforms (6)

Each option deep-links to a new chat with the page URL + source pre-filled as the first message. The reader picks their preferred LLM and starts from a context-aware conversation.

MCP server (4)

The Model Context Protocol server (Phase 3.3) lets LLMs query the component library and search docs interactively, instead of relying on a paste. These options bootstrap the connection:

Configure from the dashboard

You can configure everything on this page two ways — edit nookdocs.config.json directly in your repo, or use the dashboard UI:

Dashboard → your project → Editor → Configurations → Layout → Contextual menu

The panel has two controls:

• Built-in sections — four checkboxes (Content, AI platforms, MCP server, Custom items). Unchecking a section hides it from every page's Copy page dropdown. Leaving all four checked (the default) is equivalent to omitting contextual.enabled entirely.

• Custom items — a repeater with Title, Subtitle, Icon, and URL fields per entry. The URL field accepts the same $page / $path / $title / $mdx template variables described below.

Hitting Save commits an updated nookdocs.config.json to your connected repo, so the two paths produce identical results — pick whichever fits your workflow.

Custom options

Add your own menu items by setting contextual.options in nookdocs.config.json (or via the dashboard — see above). Each option appears in a "Custom" section below the built-ins.

{
  "contextual": {
    "options": [
      {
        "title": "File a bug report",
        "description": "GitHub issues for the docs team",
        "icon": "bug",
        "href": "https://github.com/acme/docs/issues/new?title=Bug+on+$path"
      },
      {
        "title": "Open in Linear",
        "description": "Create a Linear ticket pre-filled with this page URL",
        "icon": "external-link",
        "href": "https://linear.app/acme/team/docs/new?title=Improve%20$title&description=$page"
      }
    ]
  }
}

Template variables

The href field supports four template variables resolved at click time:

Disable built-in sections

If a section doesn't fit your tenant's workflow, hide it via contextual.enabled:

{
  "contextual": {
    "enabled": ["content", "ai-platforms", "custom"]
  }
}

This config shows Content, AI platforms, and Custom — but hides MCP server because the tenant isn't using one yet.

Omit the enabled key entirely to show all sections (the default).

Display position

The menu defaults to the page header (top-end corner of the h1 row). The Phase 3 plan includes an alternative display: "toc" mode that moves the menu into the right TOC sidebar — useful for very narrow page layouts where the header is crowded. That mode is queued for a follow-up commit and not yet surfaced in the dashboard UI; tenants who want to experiment can hand-edit the display key in nookdocs.config.json and it will round-trip through the dashboard without being clobbered on Save.

{
  "contextual": {
    "display": "header"
  }
}

Phase 1 → Phase 3 evolution

The Copy Page dropdown started in Phase 1 with five options (Copy MD, Copy for LLMs, Copy URL, ChatGPT, Claude). Phase 3.2 expanded it to 14 built-ins + custom support. The data contract stayed the same — source, url, title, description props on <CopyPageMenu> — so the upgrade was additive.

What's coming