Skip to content

[wip] Redesign index page - #6915

Draft
ethanpalm wants to merge 2 commits into
mainfrom
redesign-index-page
Draft

[wip] Redesign index page#6915
ethanpalm wants to merge 2 commits into
mainfrom
redesign-index-page

Conversation

@ethanpalm

Copy link
Copy Markdown
Collaborator

Documentation changes

Applies our new design language to the docs homepage


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Ports the landing site's design system (mintlify/landing public/design.md) to
the docs home page: warm neutral surfaces, hairline rails framing the content
column, a dot field in the page margins, 6px cards, and the brand green that
shifts hue between light and dark.

- Add home.css with the landing tokens, scoped to `.mint-home` so nothing
  reaches the rest of the site.
- Replace the illustrated HeroCards with icon-led cards on the landing card
  spec (muted Lucide icon, whitespace, bottom-anchored title and description,
  hover reveals a trailing arrow and tints the icon brand green).
- Swap the decorative hero SVGs for a CSS dot field, and add a copy-to-clipboard
  CLI install command to the hero, matching the landing hero's CTA row.
- Keep headings in Inter at the landing display sizes and tracking; the serif
  display face is licensed and not available to the docs build.

Copy is unchanged.
The introduction hero now leads with the full "set up Mintlify with your agent"
prompt from the quickstart instead of `npm i -g mint`. It lands collapsed to
four lines behind a fade and expands in place, with Copy prompt and Open in
Cursor reachable in both states — reading the prompt is optional, running it is
the point.

The prompt text now also exists as a string in
snippets/setup-agent-prompt-text.mdx, because the built-in <Prompt> component
serializes its children's source rather than evaluating them and so cannot be
handed a variable. Both copies must be edited together;
.github/workflows/check-prompt-sync.yml fails the build if they drift.

The quickstart's <Prompt> card is unchanged, byte for byte.
@mintlify

mintlify Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 8, 2026, 12:02 AM

@mintlify

mintlify Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 8, 2026, 12:02 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants