Preview the prompt +
# Build brief — an original marketing website in the taste of Mintlify
> Reference: https://www.mintlify.com · UIDiscovery: https://uidiscovery.com/sites/mintlify · captured 2026-09-22 at a 1440px desktop viewport (+ 390px iPhone shots) · [full page](https://uidiscovery.com/media/captures/mintlify/full.webp) · [scroll video](https://uidiscovery.com/media/captures/mintlify/preview.mp4)
## 1. Goal
Build an original marketing website for **[the user's brand]** that feels as considered as Mintlify — same structure, rhythm and polish, entirely new identity and content.
## 2. Originality rules
- Build an ORIGINAL design for the user's own brand in the same *taste* as Mintlify: structure, rhythm, hierarchy, palette mood and type pairing.
- Never reuse Mintlify's logo, name, product imagery, illustrations, icons, screenshots or copy. Write new copy for the user's product.
- If the user hasn't said what their product is, ask first (or use clearly marked placeholders like [Brand], [Product], [Audience]).
- Reference screenshots are for looking at, not for embedding or tracing.
## 3. The taste, in short
- Mintlify (mintlify.com): AI marketing website, dark.
- 9 sections: Hero → Content → Features → Content → Blog → Footer.
- Spacing: about a screen per idea (median section ≈853px).
- Hero headline: 6 words — short and punchy; keep yours under ~9.
- Type: one family (Arizona Flare). Imagery: mostly typography with little or no imagery, some photography.
## 4. Page structure (top to bottom)
### 1. Hero — state what the product is and for whom in one glance, and offer the primary action.
- Layout: headline-led stack: eyebrow → H1 → supporting line → actions, with a visual beside or below. About one full screen (992px at 1440), own dark band #640000; 5 images/icons (a set of cards or a small gallery); 3 text links instead of buttons.
- Slots: Eyebrow / announcement pill (optional); H1 (~6 words, like the reference); Supporting line, 1–2 sentences; Text link action; Hero visual (see image plan).
- Topic (tone/length only — never reuse): “The knowledge infrastructure agents build on”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-01.webp)
### 2. Content — supporting content that deepens one idea.
- Layout: text + media block. Half to one screen (638px at 1440), own dark band #640000; 19 image elements (icons, logos, product UI — not 19 photos); 6 text links instead of buttons.
- Slots: Heading (~11 words, like the reference); Body copy; Supporting visual (see image plan); Text link action.
- Topic (tone/length only — never reuse): “Join 20,000+ of the world's most ambitious companies building for agents.”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-02.webp)
### 3. Content — supporting content that deepens one idea.
- Layout: text + media block. Tall, ≈1.8 screens (1660px at 1440), own dark band #640000; 1 image/graphic; 1 text link instead of buttons.
- Slots: Heading (~13 words, like the reference); Body copy; Supporting visual (see image plan); Text link action.
- Topic (tone/length only — never reuse): “One platform for your entire knowledge stack. Agents that keep work moving 24/7.”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-03.webp) · imagery: slot 1
### 4. Content — supporting content that deepens one idea.
- Layout: text + media block. About one full screen (864px at 1440), own dark band #640000; 11 images/icons (a set of cards or a small gallery); primary + secondary button.
- Slots: Heading (~14 words, like the reference); Body copy; Supporting visual (see image plan); Primary + secondary action.
- Topic (tone/length only — never reuse): “Powering businesses of all sizes. Run your business on a reliable platform that…”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-04.webp) · imagery: slot 2
### 5. Features — explain the key benefits, grouped so each can be scanned in seconds.
- Layout: section title over a grid or alternating rows of benefit items. About one full screen (853px at 1440), own dark band #640000; 4 images/icons (a set of cards or a small gallery); 1 text link instead of buttons.
- Slots: Section title (~14 words, like the reference); 4 items: icon or visual + short title + 1–2 line description; Text link action.
- Topic (tone/length only — never reuse): “Built to scale with the agent web. Built for scale with enterprise-grade…”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-05.webp)
### 6. Features — explain the key benefits, grouped so each can be scanned in seconds.
- Layout: section title over a grid or alternating rows of benefit items. About one full screen (906px at 1440), own dark band #640000; 24 image elements (icons, logos, product UI — not 24 photos); primary + secondary button.
- Slots: Section title (~14 words, like the reference); 3 items: icon or visual + short title + 1–2 line description; Primary + secondary action.
- Topic (tone/length only — never reuse): “Enabling the next generation of startups. Powering a quarter of the last YC…”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-06.webp) · imagery: slot 3
### 7. Content — supporting content that deepens one idea.
- Layout: text + media block. About one full screen (847px at 1440), own dark band #640000; 7 images/icons (a set of cards or a small gallery); 1 text link instead of buttons.
- Slots: Heading (~6 words, like the reference); Body copy; Supporting visual (see image plan); Text link action.
- Topic (tone/length only — never reuse): “Trusted by teams building for agents.”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-07.webp)
### 8. Blog — signal an active, credible team through recent writing.
- Layout: 3-up card grid: image, title, meta. About one full screen (766px at 1440), own dark band #640000; 7 images/icons (a set of cards or a small gallery); 7 text links instead of buttons.
- Slots: Title + “All posts” link; 3 post cards: cover image, title, date/author.
- Topic (tone/length only — never reuse): “Latest updates”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-08.webp) · imagery: slot 1
### 9. Footer — navigation, legal and contact — the page's index.
- Layout: multi-column link groups, brand line, legal row. Half to one screen (721px at 1440), own dark band #640000; 7 images/icons (a set of cards or a small gallery); 3 buttons (tabs, toggles or per-card actions), 34 links (link lists / navigation).
- Slots: Brand mark + one-line description; 3–5 link columns; Newsletter or contact (optional); Legal row + social icons.
- Topic (tone/length only — never reuse): “Explore”
- [Screenshot](https://uidiscovery.com/media/captures/mintlify/s-09.webp)
Inner pages also captured (Pricing, Product, Customers, Sign up, Blog, Docs, Enterprise, Careers, Contact, Security): https://uidiscovery.com/sites/mintlify?view=pages
## 5. Design system
### Colour
| Role | Hex | Use | Contrast on background |
|---|---|---|---|
| background | `#020000` | page background | — |
| foreground | `#ffffff` | body text, headings | 20.9:1 |
| accent | `#640000` | primary buttons, links, highlights — sparingly | 1.5:1 ⚠ not for text; use as a fill with #ffffff text (13.6:1) |
| surface | `#121715` | cards, inputs, alternate bands | text on it 18.1:1 |
| muted | `#faf8f5` | secondary text, borders | 19.8:1 |
Captured palette: `#020000` `#640000` `#ffffff` `#fefdfb` `#121715` `#faf8f5`. Roles are assigned automatically — sanity-check them against the screenshot. Keep the palette's *mood* (dark, warm) and proportions; swap the accent for the user's brand colour.
### Tokens
```css
:root {
--background: #020000;
--foreground: #ffffff;
--accent: #640000;
--surface: #121715;
--muted: #faf8f5;
--font-heading: "Inter", ui-sans-serif, system-ui, sans-serif;
--font-body: "Inter", ui-sans-serif, system-ui, sans-serif;
--radius: 12px; /* calibrate from the screenshot */
}
/* Tailwind v4 — in globals.css after @import "tailwindcss"; */
@theme {
--color-background: var(--background);
--color-foreground: var(--foreground);
--color-accent: var(--accent);
--color-surface: var(--surface);
--color-muted: var(--muted);
--font-heading: var(--font-heading);
--font-sans: var(--font-body);
}
```
### Typography
- Headings: **Inter** (Google Fonts) — reference uses Arizona Flare. “Arizona Flare” is likely a custom or licensed face. Inter is a neutral stand-in — pick a closer free match by eye from the screenshot.
- Body: same family — a single-family system; create contrast with size and weight, not a second face.
- Scale (starting point, sizes weren't measured — calibrate against the 1440px screenshot): display clamp(2.75rem, 6vw, 5rem), h2 clamp(1.75rem, 3vw, 2.5rem), h3 1.25rem, body 1rem–1.125rem / 1.6, small 0.875rem. Headings: tight tracking (-0.02em), line-height 1.05–1.15.
### Spacing & rhythm
Sections run ≈853px tall at 1440 (median; range 638–1660px, captures cap at 1700px) — roughly a screen per idea. Start with 96–120px vertical padding per section on desktop and about two-thirds of that on mobile. One continuous background — separate sections with space and type, not colour bands. 8px spacing grid, 1200–1280px max content width, 24px (mobile) / 32–48px (desktop) gutters.
### Shape, depth & theme
On dark, separate layers with 1px borders at ~8–12% white and soft glows instead of drop shadows. Read exact corner radius, border and shadow treatment from the screenshots. Dark-first; for a light mode swap background ↔ foreground, lighten the surface, keep the accent and re-check contrast.
## 6. Imagery plan
Measured from 5 section screenshots: mostly **typography with little or no imagery**, some photography (dark, warm, AI). Still glance at the linked screenshots to match the exact mood.
### Slot 1 · 3. Content, 8. Blog → abstract 3D / gradient (uncertain)
- Dark AI section with a few graphics — typically abstract 3D/gradient art or a product shot. Count: one consistent treatment across these sections. Aspect: 4:5. Look first: [ref 1](https://uidiscovery.com/media/captures/mintlify/s-03.webp) [ref 2](https://uidiscovery.com/media/captures/mintlify/s-08.webp)
- **Stock** — “abstract dark gradient 3d”: [Unsplash](https://unsplash.com/s/photos/abstract-dark-gradient-3d?orientation=portrait) · [Pexels](https://www.pexels.com/search/abstract%20dark%20gradient%203d/?orientation=portrait) · [Pixabay](https://pixabay.com/images/search/abstract%20dark%20gradient%203d/?orientation=vertical)
- **Generate** — `Abstract 3D render: soft, glossy glass-like shapes and a smooth gradient in #640000 and #faf8f5 on a #020000 background. Lighting: low-key, moody directional light with deep shadows; warm tone. Minimal and calm, generous negative space on one side for text. Aspect ratio 4:5. No text, no letters, no logos, no watermarks, no brand marks or trademarked products, no recognisable real people.`
### Slot 2 · 4. Content → photography
- Photography, seen in the capture (people, adult, crowd). (measured from the screenshot) Count: a set of ~11 in one consistent style. Aspect: 4:5. Look first: [ref 1](https://uidiscovery.com/media/captures/mintlify/s-04.webp)
- **Stock** — “abstract gradient mesh close up dark”: [Unsplash](https://unsplash.com/s/photos/abstract-gradient-mesh-close-up-dark?orientation=portrait) · [Pexels](https://www.pexels.com/search/abstract%20gradient%20mesh%20close%20up%20dark/?orientation=portrait) · [Pixabay](https://pixabay.com/images/search/abstract%20gradient%20mesh%20close%20up%20dark/?orientation=vertical)
- **Generate** — `Photograph: abstract gradient mesh close up. Composition: simple composition with one focal point. Lighting: low-key, moody directional light with deep shadows. Warm colour grade that sits on #640000, #121715. Photorealistic, natural textures, shallow depth of field, 35mm lens. Aspect ratio 4:5. No text, no letters, no logos, no watermarks, no brand marks or trademarked products, no recognisable real people.`
### Slot 3 · 6. Features → product UI (uncertain)
- AI features with 24 image elements — most likely product UI screenshots/mockups plus icons. Count: 1–3 key visuals; the rest are icons/avatars. Aspect: 4:3. Look first: [ref 1](https://uidiscovery.com/media/captures/mintlify/s-06.webp)
- **Stock** — “laptop blank screen minimal desk”: [Unsplash](https://unsplash.com/s/photos/laptop-blank-screen-minimal-desk?orientation=landscape) · [Pexels](https://www.pexels.com/search/laptop%20blank%20screen%20minimal%20desk/?orientation=landscape) · [Pixabay](https://pixabay.com/images/search/laptop%20blank%20screen%20minimal%20desk/?orientation=horizontal)
- **Generate** — `Product-shot backdrop for a UI screenshot: smooth dark gradient from #020000 to #121715 with a soft #640000 glow behind the centre, subtle floor shadow, empty centre area where a screenshot will be placed. Lighting: low-key, moody directional light with deep shadows. Aspect ratio 4:3. No text, no letters, no logos, no watermarks, no brand marks or trademarked products, no recognisable real people. No UI elements.`
- Build the UI itself in HTML/CSS with realistic sample data from YOUR product (or screenshot your real app). Don't generate UI as an image and don't reuse the reference's screenshots. Stock/AI is only for the backdrop or device frame.
- **No imagery (type-led)** — 1. Hero, 2. Content, 5. Features, 7. Content: No imagery needed — type, spacing and colour do the work. If the screenshot shows a background graphic, rebuild it in CSS (gradient, grid, noise) or a short muted video, not a stock photo.
- **Icons** — 9. Footer: Use one open-source icon set at one stroke weight — Lucide, Phosphor or Heroicons (MIT) — tinted with the text or accent token. Social icons: Simple Icons.
### If the screenshots show a different style
Open the refs first and name what you actually see (photo / product UI / illustration / abstract gradient or 3D / type only). If it differs from the guess, switch routes — UI is built in code, type-only needs no image, otherwise:
- **illustration** — generate `Flat vector illustration: abstract gradient mesh, friendly simplified shapes, limited palette of #640000, #121715 plus one soft neutral, plenty of empty background, consistent line weight, warm mood. Aspect ratio 16:9. No text, no letters, no logos, no watermarks, no brand marks or trademarked products, no recognisable real people.` · stock: [“technology flat illustration” on Unsplash](https://unsplash.com/s/photos/technology-flat-illustration?orientation=landscape) (same query works on Pexels/Pixabay)
- **Licences:** Unsplash and Pexels images are free for commercial use under their own licences; Pixabay under the Pixabay Content License. Check each image's page before use, credit the photographer when asked (good practice anyway), and skip images showing logos, trademarks, branded products or identifiable people without a release.
- **AI generation:** the prompts work with any image model (GPT Image, Imagen, Flux, Midjourney, Firefly, SDXL…) — check its commercial-use terms. Never put the reference brand's name or “in the style of <brand>” in a prompt.
- **Never** download, trace or re-host the reference's own images, illustrations, product shots or logos.
## 7. Build steps
1. Confirm brand, product, audience and the primary action with the user.
2. Set up the tokens (CSS variables / Tailwind @theme) and load the fonts.
3. Build the sections in order, mobile-first, with each reference screenshot open.
4. Write original copy for every slot — match length and tone, never the words.
5. Source every image via the imagery plan (stock or generated); compress it and record credits.
6. Run the checklist at 390 / 768 / 1440px and fix what fails.
## 8. Acceptance checklist
- [ ] Responsive at 390px, 768px and 1440px — no horizontal scroll, tap targets ≥ 44px on mobile.
- [ ] Colour contrast WCAG AA: 4.5:1 body text, 3:1 large text and UI; visible focus states; full keyboard navigation.
- [ ] Semantic HTML: one <h1>, ordered headings, landmarks (header/nav/main/footer), labelled form fields, alt text on meaningful images.
- [ ] Performance: modern image formats with width/height set, lazy-load below the fold, ≤ 2 font families with font-display: swap, LCP < 2.5s.
- [ ] prefers-reduced-motion respected; animations under ~300ms and never blocking content.
- [ ] Originality: no copied logos, images, illustrations or copy from the reference; every image licensed or generated; credits recorded.
## 9. If you use Next.js + Tailwind
Paste the @theme block into globals.css, load fonts with next/font/google, make each section a server component in components/sections/, use next/image with explicit sizes, and keep client components for interactive bits only (menus, toggles, accordions).
---
More: tokens https://uidiscovery.com/api/v1/sites/mintlify/tokens · kit https://uidiscovery.com/api/v1/sites/mintlify/kit · MCP `get_design_brief({ slug: "mintlify" })`, `get_image_plan({ slug: "mintlify" })`. Cite the reference as https://uidiscovery.com/sites/mintlify.
