Draft improvements from assistant conversations: sidebar/font CSS and OpenAPI URL note

[mintlify]

Summary

Fill small documentation gaps that surfaced repeatedly in assistant conversations, so readers can resolve common styling and OpenAPI questions without needing the assistant.

Changes

• Added a "Common customizations" section to customize/custom-scripts.mdx with worked CSS examples for sidebar width, sidebar font size, body font size, and hiding the topbar CTA button. Explicitly notes that docs.json does not expose these as settings.
• Clarified in api-playground/openapi-setup.mdx that a hosted OpenAPI URL must be publicly reachable at build time (no localhost or private hosts).

Context

Recurring assistant questions during the review window asked how to change sidebar width, reduce font size, hide the sign-in button, and whether a locally-served OpenAPI spec URL would work. The underlying selectors and URL-based openapi config were already documented, but users were not finding actionable answers on the existing pages.

---

Note

Low Risk
Documentation-only edits with no product or runtime behavior changes.

Overview
Adds a Common customizations section to customize/custom-scripts.mdx with copy-paste CSS for sidebar width, sidebar and body font sizes, and hiding #topbar-cta-button, plus a note that these layout details are not available in docs.json appearance settings.

In api-playground/openapi-setup.mdx, extends the openapi URL guidance to state that hosted specs must be publicly reachable at build time (not localhost or private hosts).

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

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Jul 10, 2026, 4:38 PM