Add Cookbooks page - #537
Conversation
New Cookbooks tab with a card gallery for all 16 kernel/cookbooks recipes, per-card feature/integration labels, live search filter (snippets/cookbook-search.jsx), sidebar external links to each cookbook subdirectory, and card artwork in images/cookbooks/.
…links Add cookbook Tips to the five integration pages with a matching cookbook, and point claude-managed-agents-kernel links (integration page + changelog) at kernel/cookbooks subdirectories.
…ookbooks-page-94e601 # Conflicts: # style.css
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Risk assessment: Low
Verdict: Low risk. Approving.
What changed (from the diff)
- New docs tab and landing page (
docs.json,cookbooks.mdx) cataloguing 16 cookbooks as cards that link out togithub.com/kernel/cookbooks. - 16 stub MDX pages under
cookbooks/whose only content is title + externalurlfrontmatter. - Card images under
images/cookbooks/. - Tip/link updates on existing integration pages and a changelog URL rewrite from absorbed repo paths to
kernel/cookbooks. - Client-side search snippet (
snippets/cookbook-search.jsx) that filters existing cards bytextContentand togglesstyle.display. - Scoped CSS: hide pagination links whose
hrefstarts with/cookbooks/, plus.cookbook-tagstyling.
Why Low (not Very Low)
This is more than a typo or copy-only edit: it adds a new nav tab, a new interactive snippet, and CSS that hides pagination for cookbook routes. Those are easy to reason about but they are a real user-facing surface on the docs site.
Why not Medium+
- No auth, billing, permissions, APIs, or infrastructure.
- No production application logic; this repo is a Mintlify docs site.
- Search uses the query only for string matching (
includes) and does not inject user input as HTML or make network calls. - CSS and navigation changes are limited to the new Cookbooks surface.
- No CODEOWNERS file and no code-owner review requirement found.
No prior approval on this PR. If later commits expand beyond docs/nav/UI (for example CI, secrets, or site-wide behavior), this approval must be re-evaluated.
Sent by Cursor Automation: Assign PR reviewers
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit 10dcac3. Configure here.
| so hide pagination that would point at them */ | ||
| #pagination a[href^="/cookbooks/"] { | ||
| display: none; | ||
| } |
There was a problem hiding this comment.
Pagination hide misses production URLs
Medium Severity
The pagination hide rule matches only hrefs that start with /cookbooks/. Docs are served under /docs, so production pagination links likely will not match and will still send readers to the empty cookbook stubs this rule is meant to hide.
Reviewed by Cursor Bugbot for commit 10dcac3. Configure here.
|
|
||
| <CookbookSearch /> | ||
|
|
||
| <Columns className="responsive-columns" cols={3}> |
There was a problem hiding this comment.
Remove features section per canvas notes
| Apply Chromium Enterprise Policies to browser sessions. | ||
| </Card> | ||
| <Card title="Modal Web Scraper" img="/images/cookbooks/modal-web-scraper.png" href="https://github.com/kernel/cookbooks/tree/main/integrations/modal-web-scraper"> | ||
| <div className="cookbook-tag">integration</div> |
There was a problem hiding this comment.
Remove this "integration" subheader
| ] | ||
| }, | ||
| { | ||
| "group": "Integrations", |
There was a problem hiding this comment.
Naming this "integrations" is confusing imo because we have guides called "Integrations" --> https://www.kernel.sh/docs/integrations/overview . What should this be called, "Examples?" "Samples?" "Reference Implementations?"
| </Card> | ||
| <Card title="AI SDK Agent" img="/images/cookbooks/ai-sdk-agent.png" href="https://github.com/kernel/cookbooks/tree/main/integrations/ai-sdk-agent"> | ||
| <div className="cookbook-tag">integration</div> | ||
| Natural language browser automation with the Vercel AI SDK and Kernel's Playwright execution API. |
There was a problem hiding this comment.
Let's try to get this in the default desktop presentation in under 3 lines:
Browser automation with the Vercel AI SDK and Kernel's Playwright execution API.
| mode: "wide" | ||
| --- | ||
|
|
||
| Every cookbook is self-contained: clone it, set your secrets, run. Use them as 1-click starts for your agents or as templates for your own automations. |
There was a problem hiding this comment.
| Every cookbook is self-contained: clone it, set your secrets, run. Use them as 1-click starts for your agents or as templates for your own automations. | |
| Self-contained cookbooks to clone and run. Use as 1-click starts for your agents or as templates for your own build. |
|
|
||
| Every cookbook is self-contained: clone it, set your secrets, run. Use them as 1-click starts for your agents or as templates for your own automations. | ||
|
|
||
| import { CookbookSearch } from '/snippets/cookbook-search.jsx'; |
2 participants
Adds a Cookbooks tab to the docs, cataloguing all 16 recipes in kernel/cookbooks. Related to the strawman in #525 — built as a separate take from main; happy to reconcile whichever direction wins.
Note
Low Risk
Documentation and navigation-only changes (links, new pages, client-side search UI) with no product API or auth behavior changes.
Overview
Adds a Cookbooks docs tab that catalogs all 16 recipes in
kernel/cookbooks, with a wide/cookbookslanding page: searchable card grid (feature vs integration labels), GitHub links per recipe, and sidebar entries backed by minimalurlfrontmatter stubs grouped into Features and Integrations.Introduces
CookbookSearchto filter cards client-side by title/description/category text, plus CSS to style category labels and hide prev/next pagination on stub cookbook routes.Cross-links and cleanup: integration guides (Browser Use, Stagehand, Vibium, Vercel AI SDK, Anthropic computer use) and Claude Managed Agents now point cookbook
<Tip>links atgithub.com/kernel/cookbooks; the changelog entry for the managed-agents cookbook is updated the same way.Reviewed by Cursor Bugbot for commit 10dcac3. Bugbot is set up for automated code reviews on this repo. Configure here.