Skip to content

docs(website): Grok Bot positioning, GitCMS links, and SEO metadata - #448

Merged
Waishnav merged 13 commits into
mainfrom
feat/website-grok-gitcms-seo
Oct 31, 2026
Merged

Waishnav merged 13 commits into
mainfrom
feat/website-grok-gitcms-seo

Conversation

@Waishnav

@Waishnav Waishnav commented Oct 31, 2026 •

Copy link
Copy Markdown
Owner

The landing page treated Grok Bot as just another chat app, even though subagents give it a strong use case: a proactive agent can hand its coding work to the Codex and Claude Code subscriptions a user already pays for instead of spending its own usage. Grok Bot now leads the host animations, is described as a proactive agent rather than a chat app, and the subagents pillar and MCP host docs explain that delegation story. The "Chat apps over MCP" docs page is renamed "Hosts over MCP" (same URL).

The docs aside gains a GitCMS card and an "Edit in GitCMS" page action that opens the current page in GitCMS's public editor preview, plus a GitCMS footer link on the landing page. Blume has no slot below its page actions, so the card and the action hang off the TableOfContents layout slot: CSS order moves the card down, and a small script clones the "Edit on GitHub" row so it keeps Blume's styling and file path. The links point at app.gitcms.dev directly because the gitcms.dev redirect currently rewrites .mdx to .md, which breaks every docs entry.

For SEO, the custom landing shell now emits the canonical, Open Graph, X card, theme-color, apple-touch-icon, and WebSite/SoftwareApplication JSON-LD tags Blume already gives docs pages. Generated OG cards use the real DevSpace mark and site palette instead of a "D" placeholder, X attribution is set site-wide, and a few long descriptions were tightened so cards and search snippets stop truncating. The closing CTA also gets its punchline: "Let the model decide that."

Verified with blume build --isolated (all 21 pages build, landing and docs JSON-LD parse, OG cards render with the logo) and screenshots of the landing, docs aside in both themes, and the GitCMS preview links for a top-level and a nested page.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features
    • Added a skills link on the landing page and a GitCMS editing link in documentation.
    • Updated the routing illustration to show tasks being delegated to coding agents.
    • Added social sharing previews and expanded search metadata for the website.
  • Documentation
    • Updated the site and guides to explain how chat apps, proactive agents, and coding agents connect and delegate tasks.
    • Clarified when a tunnel is needed to use MCP connections.

Waishnav and others added 4 commits October 31, 2026 16:00
Grok Bot opens the host animations and is described as a proactive agent rather than a chat app. The subagents pillar and MCP host docs now explain delegating its coding work to the user's existing Codex and Claude Code subscriptions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The docs aside gets a GitCMS card and an "Edit in GitCMS" page action that opens the current page in GitCMS's public editor preview.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The landing page now emits canonical, Open Graph, X card, theme-color, apple-touch-icon, and WebSite/SoftwareApplication JSON-LD tags, matching what Blume already emits for docs pages. Generated OG cards carry the real DevSpace mark and site palette, X attribution is set site-wide, and long page descriptions are shortened so cards and search snippets don't truncate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Oct 31, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Caution

Review failed

The pull request is closed.

Walkthrough

The website updates its agent and delegation descriptions, landing-page content, routing visuals, and SEO metadata. It also adds a landing-page skills card and GitCMS editing links beside matching documentation edit links.

Changes: Website messaging and landing page

Layer / File(s) Summary
Agent messaging and examples
website/blume.config.ts, website/docs/*, website/landing/content.ts, website/landing/home/RoutingMap.astro, website/islands/DelegationDiagram.tsx, website/logos/index.ts
Descriptions and examples identify proactive agents and update delegation scenarios. The routing-map caption, accessible labels, and host ordering also reflect the updated examples.
Delegation diagram routing
website/islands/DelegationDiagram.tsx, website/ui/routing.css
The diagram adds provider-specific routing curves. Targeted curves become active when routing starts and use the current phase class.
Landing page skills link
website/landing/Icon.astro, website/landing/home/Landing.astro, website/landing/home/SkillsPopover.astro
The landing page adds a skills card with host logos, a footer link, and a second call-to-action line. The card is hidden at viewport widths of 720px or less.
Site and social metadata
website/blume.config.ts, website/landing/Shell.astro
Configuration and the shared page shell add social-card settings, pathname-based canonical and Open Graph URLs, Twitter metadata, and JSON-LD.

Documentation edit links

Layer / File(s) Summary
GitCMS documentation editing
website/components.ts, website/ui/DocsAside.astro
The table-of-contents layout uses a new aside wrapper. For matching documentation edit links, the wrapper adds a GitCMS editor link and displays a GitCMS card on desktop.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Change: Feature

Possibly related PRs

  • Waishnav/devspace#420: Adds the website structure and Blume configuration that this PR updates.
  • Waishnav/devspace#405: Defines host-based MCP tool-surface selection reflected in this PR’s documentation updates.
  • Waishnav/devspace#422: Adds the landing mock scaling and delegation diagram that this PR extends with provider routing curves.
Merge Risk: Moderate · up to e80d0

The website changes introduce lint errors that block CI and prevent later smoke tests from running. Fix the declaration spacing and add the assertion justification before merging.

- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

A rabbit reads the hosts by name,
Then watches routing curves take aim.
A skills card glows beside the page,
New edit links join the docs’ next stage.
The rabbit hops through metadata bright,
And tucks the updated site in for the night.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 31, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: In progress 🔵

View logs ↗
d9ed191 2026-10-31T10:44:07.826Z View logs ↗
  • Build: Success ✅

View logs ↗
No Preview URL. Enable ↗ f3cb2a4 2026-10-31T10:43:00.893Z Visit the dashboard ↗
  • Build: In progress 🔵

View logs ↗
79100e2 2026-10-31T10:40:02.674Z View logs ↗
  • Build: Success ✅

View logs ↗
No Preview URL. Enable ↗ e80d003 2026-10-31T10:39:02.228Z Visit the dashboard ↗
  • Build: Success ✅

View logs ↗
No Preview URL. Enable ↗ 2430717 2026-10-31T10:35:51.072Z Visit the dashboard ↗
  • Build: Success ✅

View logs ↗
No Preview URL. Enable ↗ 4a4fd2c 2026-10-31T10:34:01.577Z Visit the dashboard ↗

Waishnav and others added 9 commits October 31, 2026 16:04
A corner card fronted by the Grok Bot, ChatGPT, and Claude marks links to the DevSpace skills on skills.sh. It is hidden on phones, where it would cover content.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
DevSpace connected to the agent list through one short wire that pointed at nothing. It now fans a curve to every agent row; routed curves flow while their agents run and turn solid when they complete.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Blume's generated card caps the logo at 32px and has no template hook, so a post-build step re-renders every card it generated with the DevSpace layout: the full-size mark beside the wordmark, the page title and description in the landing fonts, and a GitHub footer. Cards stay per page because the script reads each page's own og:image, title, and description.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The corner card now opens a popover with copyable install commands for the subagents and dynamic workflows skills, keeping skills.sh as a secondary link. Installs from these commands also keep the workflows skill listed on skills.sh.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Waishnav
Waishnav merged commit d7ee92a into main Oct 31, 2026
0 of 3 checks passed
Waishnav added a commit that referenced this pull request Oct 31, 2026
Readable-spacing fixes and a SAFETY note on the cloned docs action row. These files reached main through #448, which merged before its lint check finished.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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