Experiment: product-oriented navigation + denser layout

[rreyn-bruno]

What this is

A prototype for discussion, not ready to merge — exploring how the docs could be laid out to reflect the product suite (API Client, CLI, VS Code Extension, API Docs), plus a density/layout pass responding to feedback that the site doesn't use space well.

Best reviewed by clicking around the Mintlify preview deployment rather than reading the diff.

Navigation (v4 only, page URLs unchanged)

• Sidebar reorganized into collapsible sections: Getting Started, Tools, Collaboration, Integrations, Reference, License Management
• Tools mirrors the product suite: API Client, Bruno CLI, VS Code Extension, API Docs. The API Client section absorbs the feature groups (Send Requests, Variables, Tests and Scripts, Auth, Secrets, Debugging)
• Docker / GitHub Actions / Jenkins moved from under the CLI to Integrations; Bru Lang, OpenCollection YAML, OpenAPI, Converters grouped under Reference
• Sections sit inside a wrapper group ("Documentation") whose header is hidden via CSS — Mintlify requires a named top-level group (an empty name breaks default-version routing), but only nested groups are collapsible
• Getting Started and Tools start expanded; everything else starts collapsed
• Visualizer moved under Response Data & Cookies as "Visualize Responses" (file not moved yet — would need a redirect before merging); Advanced Guides section removed; tests intro renamed "Writing Tests"

Layout & density (style.css)

• Body text 16px → 14.5px, tighter line-height and heading/paragraph margins; screenshots capped at 580px; compact sidebar
• Full-width layout: sidebar at the viewport's left edge, content column centered between sidebar and TOC at 70rem
• Sidebar tinted as a distinct panel; section headers bolded

⚠️ Scope caveats

• style.css is global — unlike the nav changes (v4-only), the CSS affects v3 pages and the entire site if merged
• The bolded-section-headers and hidden-wrapper-header rules depend on Mintlify DOM details (inline style values, :only-child structure) and could quietly stop applying after a Mintlify platform update — worth hardening before a real merge
• Mock Server has no docs yet; it has a natural home under Tools when content exists

🤖 Generated with Claude Code

[mintlify]

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

Project	Status	Preview	Updated (UTC)
bruno-docs-main	🟢 Ready	View Preview	Aug 4, 2026, 4:25 PM