Mintlify Landing
Style direction: Reference landing study
$ npx cactus add mintlify Image Placeholder Rule
- Wherever the design calls for an image, logo, screenshot, illustration, thumbnail, avatar, chart preview, or product mockup, render an empty
divwith a neutral gray background instead. - Keep the placeholder empty and match the intended size, aspect ratio, border radius, and spacing, but do not build dashboard shells, browser chrome, fake charts, or other coded internals to simulate the visual.
Design Tokens
Colors
| Token | Value | Usage |
|---|---|---|
| Background | #ffffff | Page background |
| Surface | #F9FAFB | Alternating section backgrounds |
| Text Primary | #111827 | Headlines, primary text |
| Text Secondary | #6B7280 | Body copy, descriptions |
| Text Muted | #9CA3AF | Captions, meta text |
| Primary | #0D9373 | Buttons, links, accents |
| Primary Foreground | #ffffff | Text on primary-colored backgrounds |
| Dark Section BG | #0C2018 | Enterprise section background |
| Dark Section Text | #ffffff | Text on dark section |
| Card BG | #ffffff | Cards on gray section backgrounds |
| Border | #E5E7EB | Card borders, dividers |
| Border Soft | #F0F1F3 | Subtle section dividers |
| Footer BG | #111111 | Footer background |
Fonts
| Usage | Font Family | Fallback |
|---|---|---|
| Body | Inter | system-ui, sans-serif |
| Heading | Inter (weight 600-700) | system-ui, sans-serif |
| Monospace | SFMono-Regular | SF Mono, Menlo, monospace |
Hero Background Treatment
Use a soft atmospheric gradient wash behind the hero instead of a sourced illustration. It should span full width as an absolute-positioned div behind the hero text and the main placeholder panel, with a fade-out at the bottom using maskImage: linear-gradient(to bottom, #000 60%, transparent 100%).
Component Structure
Use a consistent outline icon set everywhere — no emojis.
Build the following components in this exact order. Each is a separate file under src/components/. The page assembles them top-to-bottom in App.tsx.
| # | Component File | Description |
|---|---|---|
| 1 | Navbar.tsx | Fixed transparent header with backdrop-blur, white text, white “Start for free” button |
| 2 | Hero.tsx | Soft background wash, white heading, subtitle, glass email input with white “Start now” button inside, large gray placeholder panel |
| 3 | LogoCloud.tsx | Two rows of neutral gray logo placeholders |
| 4 | IntelligenceAge.tsx | ”Built for the intelligence age” — 3 cards (2 top + 1 full-width bottom) |
| 5 | AIAssistant.tsx | ”Intelligent assistance” — heading + large gray placeholder panel |
| 6 | Enterprise.tsx | Dark green section — enterprise features + CTA |
| 7 | CaseStudy.tsx | Featured case study card + stats + logo bar |
| 8 | IndustryShowcase.tsx | ”Unlock knowledge for any industry” — 3-card carousel |
| 9 | BottomCTA.tsx | Final CTA section with two buttons + two info columns |
| 10 | Footer.tsx | Dark footer with link columns, social icons, status |
App.tsx assembly order:
<Navbar />
<Hero />
<LogoCloud />
<IntelligenceAge />
<AIAssistant />
<Enterprise />
<CaseStudy />
<IndustryShowcase />
<BottomCTA />
<Footer />
Visual Design Reference
Light mode only — clean, white-background, documentation-focused design.
Overall Aesthetic
- White background with subtle gray (
#F9FAFB) alternating sections for rhythm - Clean sans-serif throughout (Inter) — headings are bold weight, not serif
- A soft atmospheric background wash creates a warm, premium feel
- Generous whitespace between sections
- Green accent color (
#0D9373) for CTAs, links, and interactive elements - Subtle borders and shadows on cards — no heavy decoration
- Dark green (
#0C2018) section for enterprise emphasis
Component #1: Navbar
- Fixed position (
fixed top-0 left-0 right-0), transparent background withbackdrop-blur-md,z-50 - No solid background color — the hero background wash shows through behind it
- The navbar sits ON TOP of the hero; the hero starts from the very top of the page (no offset for the header)
- Height: ~56px (
h-14) - Left: simple leaf icon + site wordmark in white bold text
- Center: Resources, Documentation, Customers, Blog, Pricing, Contact sales — all white text:
text-sm text-white/80 hover:text-white - Right: “Start for free” pill button — white background with dark text:
bg-white text-text-primary rounded-full px-5 py-2 text-sm font-medium hover:bg-white/90 - Mobile: hamburger toggle (white icon), slide-down menu with
bg-black/30 backdrop-blur-mdbackground, white links
<header className="fixed top-0 left-0 right-0 z-50 backdrop-blur-md">
...
{/* CTA — white bg, dark text */}
<a className="hidden rounded-full bg-white px-5 py-2 text-sm font-medium text-text-primary transition-colors hover:bg-white/90 md:inline-flex">
Start for free
</a>
Component #2: Hero
The hero is a single component containing the heading, subtitle, email input, and a large gray placeholder panel for the product visual area.
Background: A soft gradient wash is rendered as an absolute-positioned div that fades out at the bottom using a CSS mask. This creates a smooth transition into the white page below.
{/* Background wash with fade-out at bottom */}
<div
className="absolute inset-0"
style={{
background: "linear-gradient(180deg, rgba(255,255,255,0.16) 0%, rgba(255,255,255,0.04) 45%, rgba(255,255,255,0) 100%)",
maskImage: "linear-gradient(to bottom, #000 60%, transparent 100%)",
WebkitMaskImage: "linear-gradient(to bottom, #000 60%, transparent 100%)",
}}
/>
Text content (inside a relative z-10 wrapper):
- Center-aligned, padding
pt-32 pb-8 md:pt-44 md:pb-12(extra top padding because the fixed navbar overlaps) max-w-4xl mx-autofor the text content- Heading:
text-4xl md:text-6xl font-semibold tracking-tight text-white(weight 600, not bold) — all hero text is white to contrast against the sky background - Subtitle:
text-lg text-white/80, max-width constrained
Email input — uses a glass/frosted effect with the “Start now” button inside the input field, aligned to the right end:
<div className="mx-auto mt-10 max-w-md">
<div className="flex h-12 items-center rounded-full border border-white/15 bg-white/10 backdrop-blur-md pl-5 pr-1.5">
<input
type="email"
placeholder="you@company.com"
className="flex-1 bg-transparent text-sm text-white placeholder:text-white/50 outline-none"
/>
<button className="flex h-9 items-center gap-2 rounded-full bg-white px-5 text-sm font-medium text-text-primary transition-colors hover:bg-white/90">
Start now
<ArrowRight className="h-4 w-4" />
</button>
</div>
</div>
Hero Visual Placeholder (inside the same Hero component, below the input row):
- Render a large rounded gray placeholder
divinstead of a sourced illustration. - The placeholder fades out at the bottom using a CSS mask:
<div className="mx-auto max-w-5xl px-6 mt-4 mb-16 md:mb-24">
<div
className="w-full rounded-3xl bg-gray-200/80"
style={{
maskImage: "linear-gradient(to bottom, #000 50%, transparent 100%)",
WebkitMaskImage: "linear-gradient(to bottom, #000 50%, transparent 100%)",
minHeight: "480px",
}}
/>
</div>
Component #3: LogoCloud
- White background section, centered
- Use neutral gray placeholder bars instead of real logo artwork.
- Each placeholder is a simple rounded bar:
<img
src={logo.src}
alt={logo.name}
className="h-8 w-auto opacity-50 grayscale transition hover:opacity-80 hover:grayscale-0"
/>
- Evenly spaced:
flex flex-wrap justify-center items-center gap-x-14 gap-y-8
Component #4: IntelligenceAge
- White background section, outer container:
max-w-6xl mx-auto px-6 - Section label: small uppercase
text-xs font-semibold tracking-widest text-text-muted(e.g. “BUILT FOR AI & HUMANS”) - Heading:
text-3xl md:text-4xl font-bold text-text-primary— “Built for the intelligence age” - Subtitle:
text-lg text-text-secondary text-balance— applytext-balancefor even line wrapping - Three cards in a
md:grid-cols-2 gap-8grid — 2 on the top row, 1 spanning full width on the bottom:- Card 1: “Built for both people and AI” — lucide icons (Users + Bot), description about product docs optimized for AI workflows and human readers alike. Mini illustration bar.
- Card 2: “Self-updating knowledge management” — lucide icons (RefreshCw + CheckCircle), description about drafting and managing content with a context-aware agent. Colored checkmark circles.
- Card 3 (
md:col-span-2): “Intelligent assistance for your users” — lucide icon (MessageSquareText), description about turning docs into guided conversations, reducing support tickets. Spans full width on the bottom row.
- All cards:
rounded-xl border border-gray-200 bg-white p-8 shadow-sm transition hover:-translate-y-0.5 hover:shadow-md - Each card has a mini illustration bar: colored rounded bars in a
bg-surface p-4 rounded-lgcontainer
Component #5: AIAssistant
- Light gray background (
bg-[#F9FAFB]) section - Heading: “Intelligent assistance for your users”
- Description: about turning every documentation visit into a guided conversation — AI assistant understands context and delivers exactly what users need
- Chat UI mockup:
rounded-xl border border-gray-200 bg-white shadow-lg overflow-hidden max-w-4xl mx-auto- Show a documentation page with an embedded chat panel on the right side
- Chat has a few message bubbles (user question + AI response)
- Clean, minimal design with subtle borders
Component #6: Enterprise
- Dark green background (
bg-[#0C2018]) full-width section - Top row: large heading “Bring intelligence to enterprise knowledge” on left (
text-white text-3xl md:text-4xl font-bold), “Explore for enterprise” button on right (border border-white/30 text-white rounded-full px-6 py-3 hover:bg-white/10) - Subtitle below heading:
text-white/70 - Two feature columns below (
md:grid-cols-2 gap-12):- “Built with partnership”: description about white-glove access, dedicated support, custom guidance, extended SLAs.
text-white/80 - “Compliance and access control”: description about SOC 2, ISO27001, GDPR compliance, SAML-based SSO.
text-white/80
- “Built with partnership”: description about white-glove access, dedicated support, custom guidance, extended SLAs.
- Each column has a bold white title + body text
Component #7: CaseStudy
- White background section
- Section label: small uppercase text
- Featured card: large rounded card with decorative background image/gradient, containing:
- “See how a high-growth team scales knowledge operations”
- “Read more →” link in primary green
- Stats row below:
flex gap-12- “2M+” large bold number + “Monthly active developers” label
- “3+” large bold number + “Products across Docs, Chat, and AI” label
- Logo bar: row of neutral gray placeholder chips,
opacity-60
Component #8: IndustryShowcase
- Light gray background section
- Section label: small uppercase text
- Heading: “Unlock knowledge for any industry”
- Subtitle: about companies across industries scaling with the platform
- Three case study cards in a row (
md:grid-cols-3 gap-6):- Card 1: Research team story — dark background, description, “Read story →”
- Card 2: Media team story — dark background, description, “Read story →”
- Card 3: Marketplace team story — colorful background, description, “Read story →”
- Each card:
rounded-xl overflow-hidden, top half is branded visual, bottom half is white with text - Carousel dots below (
flex gap-2 justify-center mt-6): two dots, one active (filled), one inactive (outline)
Component #9: BottomCTA
- White background, center-aligned, generous padding (
py-24 md:py-32) - Heading:
text-3xl md:text-5xl font-bold text-gray-900— “Make documentation your winning advantage” - Subtitle:
text-gray-500— “Join the leaders of tomorrow to future-proof your documentation today.” - Two buttons side by side:
- Primary: “Get started for free” (
bg-primary text-white rounded-full px-6 py-3) - Secondary: “Get a demo” (
border border-gray-300 text-gray-700 rounded-full px-6 py-3)
- Primary: “Get started for free” (
- Two info columns below (
md:grid-cols-2 gap-12 mt-12 text-center):- “Pricing on your terms” — short description + “Pricing details →” link
- “Start building” — short description + “Quickstart →” link
Component #10: Footer
- Dark background (
bg-[#111111] text-white) full-width footer max-w-7xl mx-autocontainer,py-16 px-6- Top row: simple brand mark and wordmark in white
- 5-column link grid (
sm:grid-cols-2 lg:grid-cols-5 gap-8):- Explore: Features, Customers, Resources, Changelog, OSS Program
- Resources: Getting Started, Blog, Pricing, Status, Marketplace
- Documentation: API Reference, Components, Changelog
- Company: Careers, Code of Conduct
- Legal: Privacy Policy, Responsible Disclosure, Terms of Service, Security, DMCA/Copyright
- Column headings:
text-sm font-semibold text-white/80 uppercase tracking-wide mb-4 - Links:
text-sm text-white/50 hover:text-white transition-colors - Social icons row: generic social icons —
text-white/50 hover:text-white - Bottom bar: “All systems normal” status dot (green) + neutral copyright text
border-t border-white/10above bottom bar
Interaction & Animation Patterns
hover:bg-gray-300on placeholder logo bars- Hover lift on cards:
hover:shadow-md hover:-translate-y-0.5 transition - Smooth
transition-colorson all interactive elements - Carousel dots: clickable, active dot fills with primary color
underline-offset-2on footer links- Respect
prefers-reduced-motionfor all animations
Spacing & Layout Rules
- All sections:
max-w-7xl mx-auto px-6for content - Text-heavy sections:
max-w-4xl mx-auto - Section padding:
py-24 md:py-32 - Section dividers:
border-t border-gray-100(subtle) — or alternate gray/white backgrounds - Card gap:
gap-6togap-8depending on card size - Typography: hero 48-60px / section headings 30-40px / card titles 18-20px / body 14-16px
- Border-radius:
rounded-lg(0.5rem) on cards,rounded-xl(0.75rem) on mockups and large cards