Skip to content

Add Foreman integration guide to Vercel section - #510

Merged
dprevoznik merged 8 commits into
mainfrom
hypeship/add-foreman-integration-guide
Aug 20, 2026
Merged

Add Foreman integration guide to Vercel section#510
dprevoznik merged 8 commits into
mainfrom
hypeship/add-foreman-integration-guide

Conversation

@dprevoznik

@dprevoznik dprevoznik commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds integrations/vercel/foreman.mdx: an overview of Foreman, what's possible with Foreman + Kernel (Eve extension gives Foreman's implementation agent a real cloud browser for auth-gated bug repro), and a link out to Foreman's own recipe for full setup.
  • Reuses the same "fast setup" quick-start prompt block from the docs homepage (CopyPromptButton).
  • Registers the page as the last entry in the Vercel nav group in docs.json.

Test plan

  • Validated docs.json is valid JSON
  • Confirmed tinker-box CSS and CopyPromptButton snippet are global (not homepage-scoped), so reuse renders correctly
  • Could not run mintlify dev / mintlify broken-links end-to-end in this sandbox (network-restricted); page structure mirrors the existing eve-extension.mdx and homepage prompt block exactly

Note

Low Risk
Documentation-only change plus a small, backward-compatible snippet API. No product, auth, or data-handling logic.

Overview
Adds a Foreman integration page under Vercel docs: how Kernel’s Eve extension gives Foreman’s implementation agent an authenticated cloud browser, with a copyable coding-agent prompt and a link to Foreman’s full recipe.

CopyPromptButton now takes optional prompt and label so other pages can reuse it; the homepage default prompt is unchanged. The page is registered last in the Vercel nav group.

Reviewed by Cursor Bugbot for commit f222cea. Bugbot is set up for automated code reviews on this repo. Configure here.

Foreman is a Vercel Eve agent, so it mounts Kernel's browser the same
way any Eve extension does. Adds an overview page linking out to
Foreman's own recipe for the full setup, plus the standard quick-start
prompt block.
@mintlify

mintlify Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Aug 20, 2026, 1:32 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

cursor[bot]
cursor Bot approved these changes Aug 20, 2026

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 4afedfe. Configure here.

Comment thread integrations/vercel/foreman.mdx Outdated
Comment thread integrations/vercel/foreman.mdx Outdated
Drops the tinker-bot image and homepage messaging from the Foreman
page and swaps in the exact prompt Foreman's own recipe publishes for
wiring up the Kernel browser, so it's copy-pasteable straight from
here. CopyPromptButton now takes the prompt and label as props (still
defaulting to the homepage's Kernel CLI prompt) instead of hardcoding
one prompt for every caller.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale comment

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after 535ae4e (Foreman copy-paste prompt + CopyPromptButton props).

Evidence

  • Codepaths: Documentation site only — new integrations/vercel/foreman.mdx, a sidebar path in docs.json, and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Existing homepage prompt is extracted to DEFAULT_PROMPT with the same text. Homepage <CopyPromptButton /> still uses defaults. No production application logic.
  • Blast radius: A public docs page and clipboard-copy UI on the docs site. No shared services, auth/billing, infrastructure, or runtime behavior.
  • Prompt content: The Foreman page publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions. The homepage default prompt is unchanged.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change with a backward-compatible snippet tweak.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

- Foreman + Kernel now leads with one sentence and breaks the four
  distinct points (auth repro, per-user identity, approval gate) into
  bullets instead of one dense paragraph.
- Drop the specific third-party agent names (Cursor, Claude Code) from
  the copy-paste prompt intro in favor of generic "coding agent" wording.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale comment

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after 77e7284 (copy-only edits on the Foreman page).

Evidence

  • Incremental change: Documentation copy only. The Foreman + Kernel subsection is split into a lead sentence plus bullets, and third-party agent names are replaced with generic “coding agent” wording. No files added or removed vs the prior assessed commit.
  • Codepaths (full PR): Documentation site only — new integrations/vercel/foreman.mdx, a sidebar path in docs.json, and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Homepage default prompt text is unchanged. Existing callers without props keep the same behavior.
  • Blast radius: Public docs page and clipboard-copy UI. No shared services, auth/billing, infrastructure, or production application logic.
  • Prompt content: The Foreman page publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change; the latest push is strictly copy/formatting.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Rename to "Quickstart prompt", drop the meta-references to this being
copied verbatim from Foreman's site, and shorten the button label back
to the default "copy prompt" instead of a long two-line label.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale comment

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after b15555a (heading/intro copy and default button label on the Foreman page).

Evidence

  • Incremental change: Documentation copy only. The section heading is renamed to “Quickstart prompt”, the intro no longer claims the prompt is copied verbatim from Foreman, and the custom two-line button label is dropped so the shared default (copy prompt) is used. The copied prompt string itself is unchanged. No files added or removed vs the prior assessed commit.
  • Codepaths (full PR): Documentation site only — new integrations/vercel/foreman.mdx, a sidebar path in docs.json, and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Homepage default prompt text is unchanged. index.mdx still renders <CopyPromptButton /> with defaults, so existing homepage behavior is preserved.
  • Blast radius: Public docs page and clipboard-copy UI. No shared services, auth/billing, infrastructure, or production application logic.
  • Prompt content: The Foreman page publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change; the latest push is strictly copy/formatting.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale comment

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after 229ef37 (merge of main into this branch).

Evidence

  • Incremental change: Merge of main only. The merge brought in already-landed replay iframe docs (browsers/replays.mdx from #511). That content is already on main, so it is not unique to this PR and does not expand what would merge.
  • Codepaths (full PR vs main): Documentation site only — new integrations/vercel/foreman.mdx, a sidebar path in docs.json, and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Homepage default prompt text is unchanged. index.mdx still renders <CopyPromptButton /> with defaults, so existing homepage behavior is preserved.
  • Blast radius: Public docs page and clipboard-copy UI. No shared services, auth/billing, infrastructure, or production application logic.
  • Prompt content: The Foreman page publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change; the latest push does not add unique production or docs surface beyond what was already assessed.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Puts the copy-prompt button and a link out to Foreman's own recipe
page side by side, so readers can jump to the full write-up without
scrolling back up.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale comment

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after 37ab39a / 99d295c (recipe link beside the quickstart prompt).

Evidence

  • Incremental change: Documentation layout only. The Foreman page wraps the existing copy-prompt control in a flex row and adds an external view the recipe link (https://ask-foreman.dev/recipes/add-the-kernel-browser) with target="_blank" and rel="noopener noreferrer". Copied prompt text, docs.json, and CopyPromptButton are unchanged vs the prior assessed commit.
  • Codepaths (full PR vs main): Documentation site only — new integrations/vercel/foreman.mdx, a sidebar path in docs.json, and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Homepage default prompt text is unchanged. index.mdx still renders <CopyPromptButton /> with defaults, so existing homepage behavior is preserved.
  • Blast radius: Public docs page and clipboard-copy UI. No shared services, auth/billing, infrastructure, or production application logic.
  • Prompt content: The Foreman page publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change; the latest push is a docs-page link and layout tweak.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale comment

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after 99d295c / 37ab39a (recipe link next to the quickstart prompt button).

Evidence

  • Incremental change: Documentation layout only. integrations/vercel/foreman.mdx wraps the existing copy-prompt button in a flex row and adds an external “view the recipe” link to Foreman’s guide. No new files; copied prompt text is unchanged.
  • Codepaths (full PR vs main): Documentation site only — new integrations/vercel/foreman.mdx, a sidebar path in docs.json, and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Homepage default prompt text is unchanged. index.mdx still renders <CopyPromptButton /> with defaults.
  • Blast radius: Public docs page and clipboard-copy UI. No shared services, auth/billing, infrastructure, or production application logic.
  • Prompt content: The Foreman page still publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change; the latest push is a page-layout link.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Puts it directly above the new Foreman page.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale comment

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after f222cea (move Eve Extension below Marketplace in the Vercel nav).

Evidence

  • Incremental change: Navigation order only. docs.json moves integrations/vercel/marketplace above integrations/vercel/eve-extension so Eve Extension sits directly above the new Foreman page. No new files, copy, or snippet changes vs the prior assessed commit.
  • Codepaths (full PR vs main): Documentation site only — new integrations/vercel/foreman.mdx, a sidebar path (plus reorder) in docs.json, and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Homepage default prompt text is unchanged. index.mdx still renders <CopyPromptButton /> with defaults, so existing homepage behavior is preserved.
  • Blast radius: Public docs page and clipboard-copy UI. No shared services, auth/billing, infrastructure, or production application logic.
  • Prompt content: The Foreman page publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change; the latest push is a sidebar reorder.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk assessment: Very Low

Decision: Previous approval stands — risk did not increase after the latest push. Not re-approving (already approved).

Re-evaluated after f222cea (Vercel nav order).

Evidence

  • Incremental change: Sidebar order only. In docs.json, the Vercel group is now overview → AI SDK → Marketplace → Eve Extension → Foreman. No page content, snippet, or prompt text changed vs the prior assessed commit.
  • Codepaths (full PR vs main): Documentation site only — new integrations/vercel/foreman.mdx, nav entries in docs.json (add Foreman; swap Eve Extension and Marketplace), and optional prompt/label props on snippets/copy-prompt-button.jsx.
  • CopyPromptButton: Homepage default prompt text is unchanged. index.mdx still renders <CopyPromptButton /> with defaults.
  • Blast radius: Public docs nav and clipboard-copy UI. No shared services, auth/billing, infrastructure, or production application logic.
  • Prompt content: The Foreman page still publishes a user-facing setup prompt to copy. That is docs content for readers, not a change to this product’s model instructions.
  • CODEOWNERS: No CODEOWNERS file in this repo, so codeowner review is not a blocker.

Safe to keep the existing approval. This remains a documentation-only change; the latest push is a sidebar reorder.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@dprevoznik
dprevoznik merged commit 87010be into main Aug 20, 2026
4 checks passed
@dprevoznik
dprevoznik deleted the hypeship/add-foreman-integration-guide branch August 20, 2026 17:56
dprevoznik added a commit that referenced this pull request Aug 21, 2026
#510 hoisted the homepage's default prompt text into a module-level
DEFAULT_PROMPT const so the Foreman page could override it via props.
That constant doesn't resolve in Mintlify's per-page render (Reference
Error: DEFAULT_PROMPT is not defined), breaking the homepage button.
#513 patched the destructuring but never touched DEFAULT_PROMPT's
scope, so the underlying failure was still live.

Move the default prompt text back inside the function body, matching
how it worked before #510, while keeping the prompt/label override
for the Foreman page.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant