1440×900 · 390×844
https://mintlify.com

Heading outline, share card & baseline checks

OUTLINE & PRIMARY CTAdense density
H1×1 · H2×9
H1
H2
H2
H3
H3
H3
H3
Primary CTAGet started
Next.jsTailwindlang=en

Words

714

Action candidates

11

Links

69/14

HTML

443 KB

SHARE CARD & METAog:image ✓

mintlify.com

Mintlify - The documentation platform for agents

Self-updating documentation for startups, enterprises, and agents.

Title chars48 ch · Ideal
Meta chars66 ch · Ideal
HEADERS & ASSETS3/6
HTTPS
HSTS
CSP
nosniff
Viewport
JSON-LD
Scripts65 ext · 89 inl
Image alt coverage10/34 (29%)
Third-party hosts8 hosts

What makes it work

Restrained emerald accent keeps docs legible

Keeping #ffffff ground and #08090a ink dominant lets the signature mint green highlight active states without tinting body text.

Full three-pane product preview shows the end state

Visitors immediately see the exact sidebar, quickstart cards and Ask Assistant bar their own docs will ship with.

Where to focus next

  1. 01

    Simplify three competing hero start actions

    Get started, Sign up with Google and Set up with agents cluster closely together in the hero.

    Keep one unmistakable primary button and format the agent setup option as a clean copyable command strip.

Colors, type scale & CSS tokens

Light ground · Green & MintText contrast 19.9:1 AAA
Click any swatch to copy HEX
mintlify.com

arizonaFlare

+ inter

ABCDEFGHIJKLMNOPQRSTUVWXYZ · 0123456789

Clean white space, mint-emerald light arcs and a real documentation UI preview make developer docs look inviting.

TYPE SCALE

50px / 16px

3.13× display ratio

RHYTHM

LH 24px

Wt 400 · Track -2px

CORNERS

4pxButton
/* Extracted design tokens from mintlify.com via VibeCheck */
:root {
  --color-bg: #ffffff;
  --color-surface: #ecf4f4;
  --color-ink: #08090a;
  --color-accent: #18b888;
  --color-muted: #cccccc;
  --font-display: "arizonaFlare", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --font-body: "inter", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --text-h1: 50px;
  --text-body: 16px;
  --leading-body: 24px;
  --tracking-display: -2px;
  --radius-button: 4px;
  --space-section: 0px;

  /* Source custom properties sample */
  --blur-lg: 16px;
  --blur-md: 12px;
  --text-lg: 1.125rem;
  --text-sm: .875rem;
  --text-xs: .75rem;
  --grid-gap: 16px;
  --text-3xl: 1.875rem;
  --c15t-text: var(--color-foreground-primary);
}

Parameters are element samples. Empty values are unknown, and individual samples are not site-wide rules.

Audit findings

Simplify three competing hero start actions

Conversion

Get started, Sign up with Google and Set up with agents cluster closely together in the hero.

→ Keep one unmistakable primary button and format the agent setup option as a clean copyable command strip.

desktop.png: Get started, Sign up with Google and Set up with agents stacked in hero

No Content-Security-Policy

Launch

A CSP is the standard way to limit script sources. Vibe-coded pages often load anything, including injected scripts.

→ Start with a report-only CSP, then default-src 'self' and an explicit script-src.

content-security-policy missing

No X-Content-Type-Options

Launch

Without nosniff, browsers may interpret a file as a different type than you sent. It is a one-line header.

→ Set X-Content-Type-Options: nosniff.

x-content-type-options missing

No Referrer-Policy

Launch

The default referrer can leak internal paths and query strings to third parties.

→ Set Referrer-Policy: strict-origin-when-cross-origin.

referrer-policy missing

Copy prompts or rules to your AI Agent

Switch between page fixes, style recreation, DESIGN.md, or a reusable SKILL.md guardrail file.

Paste into Claude Code / Cursor / Codex chatFull Taste Skill guide →
Improve the current project using the 2026-11-11T06:49:26.277Z snapshot of https://mintlify.com. First identify changes since capture; do not revert newer behavior to the old snapshot.

Design baseline
An arizonaFlare 50px left-aligned hero with Google sign-up and agent setup cue sits above a crisp three-pane documentation interface.
{
  "colors": [
    {
      "role": "bg",
      "hex": "#ffffff"
    },
    {
      "role": "surface",
      "hex": "#ecf4f4"
    },
    {
      "role": "ink",
      "hex": "#08090a"
    },
    {
      "role": "accent",
      "hex": "#18b888"
    },
    {
      "role": "muted",
      "hex": "#cccccc"
    }
  ],
  "fonts": {
    "body": "inter",
    "display": "arizonaFlare",
    "stack": [
      "inter",
      "arizonaFlare",
      "paperMono"
    ]
  },
  "radius": {
    "button": "4px",
    "card": "",
    "field": ""
  },
  "space": {
    "section": "0px",
    "card": ""
  },
  "type": {
    "h1": "50px",
    "body": "16px",
    "weight": "400",
    "lineHeight": "24px",
    "letterSpacing": "-2px"
  }
}
Values come from one capture. Fonts, radii and spacing are element samples, not a universal site-wide specification. Empty values are unknown. HTML bytes are source size, not compressed transfer size; script counts are DOM tags, not network requests.

Actions
1. Simplify three competing hero start actions
Keep one unmistakable primary button and format the agent setup option as a clean copyable command strip.
Evidence: desktop.png: Get started, Sign up with Google and Set up with agents stacked in hero

2. No Content-Security-Policy
Start with a report-only CSP, then default-src 'self' and an explicit script-src.
Evidence: content-security-policy missing

3. No X-Content-Type-Options
Set X-Content-Type-Options: nosniff.
Evidence: x-content-type-options missing

4. No Referrer-Policy
Set Referrer-Policy: strict-origin-when-cross-origin.
Evidence: referrer-policy missing

Acceptance
- Check text, layout and the main action “Get started” at 1440×900 and 390×844.
- Preserve branding, authentication and business behavior. A screenshot does not prove broken interaction.
- Change only evidence-backed issues. Validate security headers against existing resources and authentication in report-only mode where supported.
- Compare before/after screenshots and run relevant functional tests. Do not claim untested behavior passed.
All token kits →