Add guide on custom page layouts

[mintlify]

Summary

Adds a new guide (guides/custom-layouts.mdx) that explains how to build custom page layouts and landing pages using Mintlify's page modes, Tailwind CSS, and components.

Changes

• New page: guides/custom-layouts.mdx — Covers choosing page modes, building hero sections, using Cards/Columns, React components, custom CSS, and a full landing page example.
• Updated: docs.json — Added guides/custom-layouts to the "Best practices" nav group (English only).
• Updated: guides/index.mdx — Added a link to the new guide in the Best practices section.

Context

Addresses DOC-46. The custom mode documentation was previously buried in the Pages reference. This guide surfaces it as a standalone, searchable resource with "landing page" as a keyword.

---

Note

Low Risk
Documentation-only changes: adds a new guide and updates navigation/linking plus minor wording/theme-support clarifications; no runtime or API behavior impact.

Overview
Adds a new guide, guides/custom-layouts.mdx, documenting how to build landing pages/custom layouts using page modes, Tailwind classes, components, optional React snippets, and custom CSS.

Surfaces the guide in navigation by adding it to docs.json (Guides → Best practices) and linking it from guides/index.mdx. Also updates organize/pages.mdx to generalize the style-prop layout-shift warning and to expand the listed theme support for frame and center modes.

^{Written by Cursor Bugbot for commit 405b2ed. This will update automatically on new commits. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Mar 21, 2026, 5:14 PM