feat: improve navigation

[dcrawbuck]

Summary

• Adds the Agents card to the home page Documentation section using the existing Agents icon.
• Replaces the desktop docs header section row with a custom header that keeps Dashboard, Agents, Web Checkout, and Integrations as main selectors while grouping SDKs into one dropdown.
• Preserves SDK-context links, fixes selector icon sizing/alignment on desktop and mobile, and shows SDK subtitles such as Beta and Deprecated in the desktop dropdown.

Validation

• bun test
• bun run build:cf

---

Note

Medium Risk
Medium risk because it replaces core docs header/tab rendering and tab URL/icon transformation, which could cause navigation or active-tab regressions across SDK-context routes.

Overview
Introduces a new custom DocsHeader for the docs notebook layout, replacing the default header row to keep primary doc areas as top-level tabs while consolidating SDK sections into a single SDK dropdown (including tab descriptions/subtitles).

Updates docs tab handling to preserve SDK-context subpaths when switching between SDK tabs, adjusts tab icon sizing/alignment via the sidebar tab transform, and removes the Integrations link from the global nav config.

Adds a new Superwall Agents card to the home docs overview grid.

^{Reviewed by Cursor Bugbot for commit ac58b71. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	superwall-docs-staging	ac58b71	Commit Preview URL Branch Preview URL	May 23 2026, 12:52 AM

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ac58b710df

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Keep navbar-only sections reachable on small screens

This header now hides all navItems below the lg breakpoint (max-lg:hidden), but support and changelog are still filtered out of sidebar tabs in src/routes/$.tsx via NAVBAR_ONLY_TABS. On mobile/tablet widths, users can no longer navigate to those sections from the docs navigation UI (they’re neither in tabs nor in visible header links), which is a functional regression for those routes.

Useful? React with 👍 / 👎.