Repository navigation
Conversation
Replace the hero cards with a prompt that sends coding agents to the quickstart's agent setup workflow, followed by three ways to work and an explore grid. Styling ports tokens and shadows from the Mentha design system into a scoped home.css; layout uses Tailwind. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Based on docs landing page research: lead with what Mintlify is, add a prominent search field that opens the site's search dialog, shorten the agent prompt to a pointer at the quickstart workflow, phrase the explore cards as tasks, drop agent brand names, and link the changelog. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Keeps JavaScript out of index.mdx so Vale lints only prose. Vale was flagging variable names and string literals in the inline export. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ethanpalm
marked this pull request as ready for review
November 3, 2026 00:47
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replaces #6915.
What changed
index.mdx: The page now runs, top to bottom:Agents get a plain-Markdown version through
<Visibility for="agents">.snippets/home-search.jsx: A search field that opens the site's own search dialog. It clicks the documented[data-search-item="trigger"]hook, so readers get the same results and the same handoff to the assistant as the navbar search. If no trigger is visible, it falls back to?search=. The shortcut hint shows ⌘K on Mac and Ctrl K elsewhere.snippets/home-setup-prompt.jsx: The prompt card, laid out like Mentha'sPromptprimitive. The prompt is one line: "Set up Mintlify for me. Fetch https://www.mintlify.com/docs/quickstart.md and follow its agent setup workflow."home.css(about 100 lines, scoped to.mentha-home): Light and dark tokens copied from Mentha'stokens.cssandpalette.css, plus theshadow-weak,shadow-base, and focus-ring shadows. Everything else is Tailwind.Rationale
The layout follows research into docs landing pages:
mint signup.@mintlify/mentha, and its unprefixed classes don't survive themint-prefix. The multi-layer shadows have to live in CSS because Mintlify drops any class that contains a comma (see Use Tailwind in place of custom styles (DOC-426) #8222).Alternatives considered
design.md. [wip] Redesign index page #6915 did this. Mentha is the newer, official system.<Prompt>component. It doesn't match Mentha's look.Areas of uncertainty
#166E3Fprimary.Checks
mint broken-links: No broken links.index.mdx.mint a11y: Only the existing site-wide theme color warnings.mint devin light, dark, and narrow viewports.🤖 Generated with Claude Code
Note
Low Risk
Docs-only UI and copy changes with no backend, auth, or data handling impact.
Overview
Replaces the image-heavy intro hero with a Mentha-scoped landing page (
mentha-home) built from newhome.csstokens (light/dark surfaces, shadows, focus rings) plus Tailwind inindex.mdx.The human view now flows overview → search → agent setup prompt → “choose how you work” path cards → task-based explore cards → changelog.
HomeSearchreuses the real site search by clicking the documented trigger (with?search=fallback and ⌘K / Ctrl K hint).HomeSetupPromptshows a one-line agent prompt with Copy and Open in Cursor, pointing agents at the quickstart workflow instead of duplicating steps on the page.<Visibility for="agents">adds a plain-Markdown equivalent of the same links and setup guidance. Front matter description/keywords are updated to match the new positioning.Reviewed by Cursor Bugbot for commit 1623dab. Bugbot is set up for automated code reviews on this repo. Configure here.