# Netlify: brand book and build spec

Netlify's official 34-page guide (May 2026) covers brand story, the spark logo system and colour in depth (every lockup, colour set, ground and minimum size; full ramps with APCA scores and the 500-point contrast rule), and type with a full scale. It shows but does not specify elements, illustration and photography, and has no voice, icon, layout or component chapters. The live site supplies the open font files (Figtree, Instrument Sans, Martian Mono, all OFL), design tokens, hand-drawn teal line art and the star mascot.

From unfairly.ai/brand-guidelines/netlify, checked 2026-11-17. Unofficial study; not affiliated with Netlify.

Every value is labelled with where it came from: **published** (the brand says it), **observed** (measured or seen on its live site, with the date), **our reading** (inferred from the evidence) or **our recipe** (how we apply the system). Files beside this one: tokens.css, tokens.json (DTCG 2025.10), kit.json.

**Thesis (our reading):** A developer platform that looks like a friendly tool: black-like neutrals and white, one bright teal spark, one blue accent, monospace labels, and a hand-drawn, slightly playful illustration layer. Based on: Teal is kept for the logo and CTAs, text stays Neutral 800 on white, Blue 700 marks emphasis; Martian Mono eyebrows and code blocks signal "for developers"; the values ask for simplicity and levity, which the wobbly line art and star mascot deliver.

## Purpose

Mission: Enable the world's developers to create, and unlock the power of the web (published; )

| Value | What it means in the work | Source |
|---|---|---|
| Be Inclusive | Act every day to create an inclusive environment; Think in partners and ecosystems; Build an inclusive product and platform. | published: guide.pdf p.7 |
| Own it, Ship it | Be a pilot, not a passenger; Listen, iterate, ship and drive results; Care about the whole business. | published: guide.pdf p.7 |
| Care deeply, and have fun | Hire people that care deeply; Bring your passion; With levity and joy and to lift each other up. | published: guide.pdf p.7 |
| Simplify | Make people think "it just works" when they think Netlify; Innovate by simple solutions to complex problems; Drive simplicity in planning, tool use, processes and workflows. | published: guide.pdf p.7 |

## Fixed and flexible

Never changes:
- The spark logo in its correct colour set
- Teal 400/200 sparks, Teal 800 or white type
- Neutral 800 (never black) and white for text
- Blue 700 as the only accent
- Figtree heads, Instrument Sans body, Martian Mono labels and code
- 500-step contrast gap

The one thing that varies: Ground (white, #12181F, Teal 900 gradient, or blue-purple glow), illustration subject, and the secondary colours for gradients and data.

## Positioning

- **Statement**: Create with AI or code, deploy instantly on production infrastructure. One platform to build and ship.
- **Category**: Web development platform: build, deploy and scale web apps (AI agents, serverless, global delivery) on one platform
- **Audience**: Developers and web teams, from solo builders and AI-agent users to enterprises

## Messaging

Boilerplate (observed): Netlify is the most popular way to build, deploy and scale modern web applications. Home to millions of developers and thousands of enterprises, Netlify is the platform of choice for running modern composable web applications in production, from global corporate sites to complex e-commerce and SaaS applications.

Taglines:
- Build a better web (Vision headline, Blue 700 on white)
- Let's build a better web together (Guide opening spread; "together" in Blue 700 on Blue 000)
- Push your ideas to the web (Home hero H1 and OG image)
- Build your way. Ship on one platform. (Home "How it works" head)
- Every building block. One platform to run it all. (Platform page H1)

| Pillar | Claim | Proof | Label |
|---|---|---|---|
| Build a better web | The web will be the #1 place for content, commerce and apps, beating walled gardens and proprietary platforms. |  | published |
| Yes, <code>! | Every developer should be able to build an amazing, highly differentiated web experience: fast, personal and safe, with strong business outcomes. | 10M+ developers | published |
| Decoupled made easy | Netlify connects APIs and developer tools with opinionated infrastructure for simple, yet powerful workflows. | 60M+ apps deployed | published |
| Focus on the code that counts | Not building middleware, coordinating with DevOps, or maintaining custom servers and infrastructure. | 99.99% uptime; 100+ global edge locations | published |

Real lines, as they wrote them:
| Line | Channel | Source |
|---|---|---|
| "Push your ideas to the web" | Homepage hero H1 and OG image | https://www.netlify.com/ |
| "Build your way. Ship on one platform." | Homepage, How it works | https://www.netlify.com/ |
| "Every building block. One platform to run it all." | Platform page H1 | https://www.netlify.com/platform/ |
| "Prompt. Preview. Repeat." | Homepage, triplet head | https://www.netlify.com/ |
| "Build a better web" | Brand guide, vision spread | guide.pdf p.5 |
| "Netlify CLI now stores your token in the OS keychain" | Bluesky changelog card | https://bsky.app/profile/netlify.com/post/3n2jlz27gkc24 |
| "Run hiring and surveys on apps your team owns" | Bluesky announcement card, FOR HR TEAMS | https://bsky.app/profile/netlify.com/post/3mzxtjd73l22y |
| "Netlify's People team built its own survey app with prompts" | Bluesky customer-story card | https://bsky.app/profile/netlify.com/post/3mzdnpb5ats2r |

## Voice

Tone words: Direct, Developer-plain, Optimistic, Inclusive, Light-hearted.

Traits:
- Direct, but not Wordy (published)
- Simple, but not Complicated (published)
- Playful, but not Corporate (our reading)
- Inclusive, but not Exclusive (published)
- Technical, but not Abstract (our reading)

- The guide publishes no voice chapter. Its rules on copy are about hierarchy: "At Netlify, we like to get right to the point"; make the important line big and the rest meaningfully smaller; no wall of text (p.32). Its values ask for simplicity ("it just works") and "levity and joy" (p.7).
- Observed on netlify.com: short declarative heads, sentence case, usually ending in a period ("Start your way.", "For every kind of web app."); staccato triplets ("Prompt. Preview. Repeat."); second-person body copy about what the reader builds; plain product nouns; numbers as proof (10M+, 99.99%).

Rules a copy check enforces:
- Lead with the most important line, large; de-emphasise details, captions and explanations by making them meaningfully smaller. Don't make all text as large as possible.
- Keep text under 65 characters per line; if a block runs longer, set it in multiple columns.
- Make people think "it just works"; simple solutions to complex problems.
- Section heads are short sentence-case statements that end in a period; the hero H1 has none.
- Three one-word imperatives as a head.
- CTAs are short verb phrases; text links end with a north-east arrow.
- Every section opens with a one- or two-word uppercase mono eyebrow.

Their words: build, ship, deploy, preview, developers, the web, AI agents, Deploy Preview.

## Color

| Name | Hex | Role | Use |
|---|---|---|---|
| Teal 800 | #014847 | Logo type on light; dark ground | Wordmark, permitted dark ground |
| Teal 400 | #05BDBA | Sparks on light | Logo sparks only; teal used sparingly outside the logo |
| Teal 200 | #32E6E2 | Sparks on dark; primary button | Logo on dark, CTA fill, accents on dark |
| Teal 900 | #0C2A2A | Deepest dark ground | Dark panels, banner ads |
| Neutral 800 | #181A1C | Black-like ink | Headlines and body; never #000000 |
| Neutral 000 | #FFFFFF | True white | Page ground; text on dark |
| Blue 700 | #2E51ED | accent | Emphasis, links, eyebrows, divider spreads |
| Purple 800 | #382AA4 | Secondary: gradients | Blend with Blue and Teal; badges/charts in UI |
| Red 500 | #FE4E5C | Secondary: warmth, danger | Attention in brand; errors in UI |
| Gold 300 | #FBB13D | Secondary: punch, warnings | Sparingly; the star mascot |
| Pink 700 | #9A2D99 | Secondary: fun | Norm-breaking designs; badges/charts in UI |
| Green 400 | #3AC364 | UI success only | Never in brand design |

## Typography

| Role | Their face | Licence | Open stand-in (Google Fonts) | Fallback |
|---|---|---|---|---|
| display | Figtree | SIL OFL 1.1 (Google Font); the site's own variable woff2 ships with this book in fonts/ | Figtree | system-ui, "Helvetica", sans-serif |
| body | Instrument Sans | SIL OFL 1.1 (Google Font); the site's own variable woff2 files (roman and italic) ship with this book | Instrument Sans | system-ui, "Helvetica", sans-serif |
| mono | Martian Mono | SIL OFL 1.1 (Google Font); the site's own woff2 files ship with this book | Martian Mono | ui-monospace, "Cascadia Code", "Source Code Pro", Menlo, Consolas, monospace |

| Role | Token | Face | Desktop | Phone | Line height | Tracking | Weight |
|---|---|---|---|---|---|---|---|
| Hero H1 and every section H2 (Figtree 800, normal tracking, sentence case; #E6ECF2 on the #12181F hero, #181A1C on white) | --text-display-2xl-* | display | 64px | 40.82px | 1.1 | 0px | 800 |
| Testimonial pull quote (Figtree 700, Blue 700 curly quotes) | --text-quote-* | display | 48px | 32.55px | 1.1 | 0px | 700 |
| Switchback and tab panel H3 (Figtree 800; white on the teal panels, #353A3E in the tab panel) | --text-panel-head-* | display | 32px | 24.27px | 1.1 | 0px | 800 |
| Start-your-way card headline (Figtree 700 #181A1C) | --text-card-head-* | display | 32px | 24.27px | 1.1 | 0px | 700 |
| Stat value (Figtree 700 #181A1C, line-height 1) | --text-stat-* | display | 32px | 24.27px | 1 | 0px | 700 |
| How-it-works step H3 (Figtree 700 #181A1C) | --text-step-head-* | display | 24px | 20.14px | 1.1 | 0px | 700 |
| Use-case tab label (Figtree 600) | --text-tab-* | display | 18px | 18px | 1.1 | 0px | 600 |
| Nav and utility links (Figtree 600 #353A3E) | --text-nav-* | display | 16px | 16px | 1.5 | 0px | 600 |
| Pill button label (Figtree 700, line-height 1) | --text-button-* | display | 16px | 16px | 1 | 0px | 700 |
| Lead under a heading (Instrument Sans 400; #353A3E on white, #DEFFFE on the hero) | --text-lead-* | body | 18px | 18px | 1.5 | 0px | 400 |
| Body, card text, list rows (Instrument Sans 400 #353A3E; white on teal panels) | --text-body-* | body | 16px | 16px | 1.5 | 0px | 400 |
| Underlined action link (Instrument Sans 500 #353A3E, underline in Blue 700, 14px north-east arrow) | --text-action-link-* | body | 16px | 16px | 1.5 | 0px | 500 |
| Announcement bar (600 #F6F6F7), footer links and legal (400 #545A61) | --text-small-* | body | 14px | 14px | 1.5 | 0px | 400 |
| Footer column heading (Instrument Sans 800 #545A61) | --text-footer-head-* | body | 16px | 16px | 1.5 | -0.4px | 800 |
| Section eyebrow (Martian Mono 400 uppercase; #2E51ED on white, #32E6E2 on teal panels) and testimonial attribution | --text-eyebrow-* | mono | 14px | 14px | 1.1 | 0px | 400 |
| Code panel text and its uppercase heading strip (Martian Mono 400) | --text-code-* | mono | 16px | 16px | 1.5 | 0px | 400 |
| CLI snippet in a card and the hero agent command (Martian Mono; 400 in the card, 700 at 12/12 in the hero pill) | --text-code-small-* | mono | 12px | 12px | 1.5 | 0px | 400 |

## Layout

Measured on guide.pdf p.10, p.11, p.12, p.13, p.14, p.15, p.16, p.17, p.18, p.20, p.21, p.22, p.23, p.24, p.26, p.27, p.28, p.29, p.30, p.31, p.32; computed styles and CSS tokens (--ntl-*) on https://www.netlify.com/, headless Chromium 2026-11-17: headless Chromium at 1440x900 and 390x844, page scrolled top to bottom, cookie banner and Ask Netlify widget ignored; y values are page coordinates at 1440 unless marked phone.

| Measure | Desktop (1440) | Phone (390) |
|---|---|---|
| Page margin | 80px | 32px |
| Section padding | 96px | 96px |
| Container max width | 1280px | full |
| Hero text width | max 560px | full |
| Gutter | 24px | 24px |
| Card gap | 24px | 24px |
| Navigation height | 74px | 74px |

Breakpoints from Netlify's CSS: 480, 500, 600, 640, 750, 768, 1024, 1085px.

Homepage bands, top to bottom (observed):
1. Announcement + header
   - Desktop: 37 + 74 = 111px, sticky
   - Phone: 79 + 61 = 140px; logo, search, Log in, menu icon
   - Blue 700 #2E51ED announcement bar (37px) over the white #FFFFFF nav (74px)
   - Bar Instrument Sans 14/21 w600 #F6F6F7 on #2E51ED, centred, close X right
   - Nav Figtree 16/24 w600 #353A3E; Sign up Teal 200 pill 93x40
2. Hero
   - Desktop: 543px; text 582px at x 80; dashed frame 666x415 at x 694; H1 2 lines "Push your ideas" / "to the web"
   - Phone: 713px; text then frame 326x214
   - H1 Figtree 64/70.4 w800 #E6ECF2; lead 18/27 #DEFFFE
   - Start building (Teal 200) + Request a demo (#292F35, Teal 200 label); "fetch https://netlify.ai" command pill
   - Static illustration: white line browser/dashboard with gold star mascot on a cloud
3. Logo strip
   - Desktop: 69px band (32px top padding); 64px gaps; faded edges
   - Phone: 64px band
   - Static resting state: Finn, Autodesk, Zscaler, ServiceTitan, Stack Overflow, Riot Games visible, Mighty and Kubernetes cut by the fades
4. How it works
   - Desktop: 1684px section; tiles 411x274 radius 16 #0C2A2A; video 1280x720 radius 16
   - Phone: 1831px; stacked tiles 326x217
   - H2 "Build your way." <br> "Ship on one platform."
   - Steps: Start with code or AI / Build fullstack apps / Go live everywhere
5. Start your way
   - Desktop: 977px; cards 628 wide, 24px gaps
   - Phone: stacked 326px cards
   - Cards: Start building with an AI agent / Deploy from Git / Deploy from terminal / Drag and drop, each with a 24px #2E51ED icon and an underlined action link
6. Feature switchbacks
   - Desktop: 1818px section; panels 492 / 576 / 462 tall, 48px apart; media left, right, left
   - Phone: text above illustration in each panel
   - Three #09181B to #0C2A2A gradient panels on the white page
   - Rows 397x58 on #E9EBED at 10% with #FFFFFF 20% borders
   - Eyebrows #32E6E2, heads white Figtree 32 w800
7. Testimonial
   - Desktop: 347px; quote 48/52.8 in 2 lines, hanging #2E51ED quotes
   - Phone: 400px; 4 lines
   - Jeffrey Sica, Kubernetes contributor, Head of Projects at CNCF
8. Use cases
   - Desktop: tabs 257x45; panel 1280x582 with a 1px #2E51ED frame; code on #060B10
   - Phone: tabs scroll sideways; panel stacks
   - AI apps / Marketing sites / SaaS apps / Ecommerce / Internal tools
9. Stats row
   - Desktop: one centred 33px row, 48px gaps
   - Phone: stacked, centred
   - Value Figtree 32 w700 + label 16px #353A3E
10. Footer
   - Desktop: 716px, content x 120-1320
   - Phone: accordions
   - All text #545A61; legal row under a 1px #E9EBED rule; © 2026 Netlify

## Page anatomy

How Netlify's own landing pages are built, part by part (observed; headless Playwright (Chromium) computed styles of https://www.netlify.com/ at 1440x900 and 390x844 after full scroll, 2026-11-17; measure/home-desk.json, measure/home-phone.json; tmp/an/home-desk.json, tmp/an/home-phone.json, 2026-11-17). A homepage pattern, not a brand law: follow it for landing pages.

**Announcement bar**
- summary: Full-width Blue 700 bar above the nav, one centred line with an underlined link, close X at the far right. Part of the sticky header.
- ground: #2E51ED
- height: 37px desktop (padding 8px), 79px phone (3 lines, left-aligned at x 8)
- copy: "Netlify goes full stack: Netlify Server is here." then the underlined link "Run long-running backends with WebSockets, now in Early Access."
- type: Instrument Sans 14/21 w600 #F6F6F7; the link underlined, same colour
- layout: text run x 334-1061 centred; close icon 20px #F6F6F7 at x 1412, y 9

**Navigation**
- summary: White (90% opaque) bar under the announcement: full-colour logo left, five Figtree menu items, then search icon, Contact, Log in and a Teal 200 Sign up pill on the right.
- ground: #FFFFFF at 90% opacity
- height: 74px desktop, 61px phone; header (announcement + nav) 111px / 140px
- border: no border; soft shadow on the whole header: 0 2px 4px rgba(51,55,59,0.08), 0 1px 10px rgba(51,55,59,0.06), present at rest
- logo: variant small full-colour light-mode logo (Teal 800 #014847 wordmark, Teal 400 #05BDBA sparks): logo-netlify-small-fullcolor-lightmode.svg; px 122x50 desktop (sparks included), 90x37 phone; position x 98, y 50 (vertically centred in the 74px row); phone x 20, y 92
- links: count 5; labels Platform | Solutions | Developers | Resources | Pricing; size 16px; weight 600; color #353A3E; alignment Figtree 16/24 w600, each a 40px box with padding 8px 12px starting x 239 (Platform 239-326, Solutions 336-428, Developers 438-544, Resources 553-653, Pricing 663-738); the first four carry a 13px chevron-down and open mega menus, Pricing is a plain link.; menus Platform: The Netlify Platform (Explore the platform) / Key Features: Agent Runners, Deploy Previews, AI Gateway, Functions, Database, Observability, Security, Edge network. Solutions: Why Netlify? (Customers, Enterprise, Partner directory, Agent experience) / Use Cases (Prototypes, Internal apps, Coding agents, Ecommerce, Marketing sites, Web apps), Chat with a Netlify expert. Developers: Where to start (Docs, Developer guides, Templates, Integrations, Build with AI) / Agents (Claude, Codex, Cursor, + More) / Frameworks (Astro, TanStack, Next.js, Wordpress, React, + More), Try Agent Runners. Resources: Blog, Changelog, Knowledge Base, Community, Events, Customers, Partner directory, All resources.
- actions: Right group in order: search icon 20px #353A3E at x 1031; Contact (x 1059) and Log in (x 1143) in the nav-link style; Sign up primary pill 93x40 at x 1219-1312.
- sticky: the whole header (announcement + nav) is position sticky, top 0; identical at rest and on scroll
- phone: shows logo 90x37 at x 20; search icon 20px at x 210; Log in (68x40) at x 250; menu icon 20px at x 351. No Sign up button and no menu labels.; menu menu icon opens the full menu (same five groups, Contact, Sign up); cta none in the bar; the hero CTAs are the first buttons

**Hero**
- summary: Dark #12181F band: left a two-line Figtree 800 H1, a two-line lead, two pills (Teal 200 primary + translucent secondary) and a small copy-command pill; right a white hand-drawn browser/dashboard illustration with the gold star mascot inside a dashed rounded "drop zone" frame.
- desktop: band y 111-654 (543px), padding 96 top / 32 bottom, ground #12181F; content row x 80-1360, items vertically centred, 32px between columns; columns text x 80-662 (582px); media frame x 694-1360 (666x415); text max width H1 box 582px, breaks exactly "Push your ideas" / "to the web" (2 lines); lead max 560px, breaks "Create with AI or code, deploy instantly on production" / "infrastructure. One platform to build and ship." (2 lines); vertical anchors frame top y 207, H1 top 228, lead top 393, buttons 479-519, caption 531, command pill 560-600, frame bottom 622; media frame 2px dashed #FFFFFF at 30% border, radius 30, padding 16, no fill; illustration 630x373 inside it, white line art; cta size pills 40px tall: Start building 138px, Request a demo 156px, 12px apart; command pill 306x40 below, 12px under the buttons plus the 21px caption
- phone: order H1, lead, two pills side by side, caption + command pill, then the framed illustration; alignment left, 32px margins; sizes band y 140-853 (713px, padding 96/32); H1 40.82/44.9 at y 236 (2 lines, 90px); lead 18/27 at y 350 (3 lines); pills at y 463 (138 + 156, 12 apart); caption y 515; command pill y 544-584; frame 326x214 at y 608 with the illustration 290x172
- at rest: Static illustration (no animation in the SVG). The command pill's dot sweep is animation only; at rest the pill is plain #292F35 with no dots.
- media: home-hero-illustration.svg
- type: H1 Figtree 64/70.4 w800 #E6ECF2, normal tracking, no period; lead Instrument Sans 18/27 w400 #DEFFFE
- cta: "Start building" (primary, to app.netlify.com/signup) and "Request a demo" (secondary on dark); then caption "Add Netlify to your coding agent" and the command pill "fetch https://netlify.ai"
- proof: none in the hero; the logo strip directly below is the proof

**Logo strip**
- summary: A single row of ten black customer logos on white, scrolling left forever, edges faded.
- ground: #FFFFFF
- desktop: band y 654-723 (padding 32 top, 0 bottom); ticker x 80-1360, 37px tall, logos 18-37px tall at natural width with 64px gaps, mask linear-gradient(to right, transparent 0%, black 15%, black 85%, transparent 100%)
- phone: band y 853-917; same row at the same logo sizes, 32px margins, about two logos visible
- anatomy:
  - Order: Meta, Mighty, Finn, Autodesk, Zscaler, ServiceTitan, Stack Overflow, Riot Games, Kubernetes, Figma (then repeats)
  - Logos are the single-colour black files (#000000, Finn #191919) at 100% opacity, no tint, no captions, no heading
  - Animation: 50s linear infinite translateX (animation only). Static resting state: Finn at x 76, Autodesk 215, Zscaler 454, ServiceTitan 658, Stack Overflow 892, Riot Games 1143, Kubernetes 1308 cut by the right fade; Mighty fading out at the left edge
- components: n-ticker

**How it works**
- summary: Left-aligned heading block, three illustrated step tiles in a row, then a full-width video.
- ground: #FFFFFF
- desktop: section y 723-2407, padding 96. Eyebrow "HOW IT WORKS" y 819; H2 y 858 in exactly 2 lines from a hard <br>: "Build your way." / "Ship on one platform." (box 800px); lead y 1023 max 560px (2 lines). Steps y 1141: three 411px columns at x 80 / 515 / 949 (24px gaps); each a 411x274 tile (radius 16, #0C2A2A), H3 30px below (y 1445), body 8px below (y 1479). Video y 1591: 1280x720, radius 16, overflow hidden.
- phone: Eyebrow y 1013; H2 40.82/44.9 in 3 lines; lead 3 lines; steps stacked: tile 326x217, H3 20.14/22.15, body, 24px between steps; video 326x183.
- anatomy:
  - Eyebrow Martian Mono 14 uppercase #2E51ED, H2 Figtree 64/70.4 w800 #181A1C, lead Instrument Sans 18/27 #353A3E: "Every path runs on the same workflow and production infrastructure, powering millions of sites and apps."
  - Step 1 "Start with code or AI" / "Start with a prompt, push from Git, or drag and drop. All paths lead to the same project." (tile: prompt box "What do you want to build?" with the typed "Help me build a health tracking app")
  - Step 2 "Build fullstack apps" / "Connect APIs, manage data, optimize images, and add AI features from your first prompt." (tile: six outlined pills Image Hosting, API, Forms, Databases, AI, Observability)
  - Step 3 "Go live everywhere" / "Deploy to a global CDN in seconds, then choose when to make your project public." (tile: app preview card, LIVE badge, "Health Tracking App", "Published: 3 minutes ago", "Open preview" button)
  - Step H3 Figtree 24/26.4 w700 #181A1C; body Instrument Sans 16/24 #353A3E; no numbers, no icons, no card border around the text
  - Video: YouTube "What is Netlify" (id Evdv_HSFHBk) as a poster image: Teal 900 ground, Martian Mono "Build me an app" with a Teal 200 cursor, white-type logo, teal glow from the bottom; a dark play button centred; radius 16
- components: step_tile, eyebrow

**Start your way**
- summary: Centred heading block over a 2x2 grid of white hairline cards, each with a blue icon, a big headline, one line and an underlined action link.
- ground: #FFFFFF
- desktop: section y 2407-3384, padding 96. Eyebrow "GET GOING" centred y 2503; H2 "Start your way." centred y 2543 (1 line); lead centred y 2637. Cards from y 2728: 628px wide at x 80 and 732 (24px gaps); row 1 235px tall, row 2 301px tall.
- phone: Heading block centred; cards stacked 326px wide, 24px apart (277, 251, 335, 275px tall); headline 24.27/26.7 (wraps to 2 lines on card 1).
- anatomy:
  - Lead: "Choose the workflow that fits how you work."
  - Card 1: icon agent-runners (robot) / "Start building with an AI agent" / "Describe what you want to build. An AI agent handles the rest." / link "Build now"
  - Card 2: icon code-branch / "Deploy from Git" / "Auto-deploy on every push. Every PR gets a preview URL." / link "Import a project"
  - Card 3: icon square-terminal / "Deploy from terminal" / "Deploy directly from your working directory. No login required to start." / CLI snippet "npm i -g netlify-cli" + "netlify deploy --allow-anonymous" with a copy icon / link "Get started with CLI"
  - Card 4: icon cloud-arrow-up / "Drag and drop" / "Drop your project folder and deploy in seconds. New projects stay private until you choose to publish." / link "Try Netlify Drop"
  - Card: 1px #E9EBED, radius 6, padding 24; icon 24px #2E51ED at the top-left; headline Figtree 32/35.2 w700 #181A1C 30px below the icon; body 24px below; action link pinned to the bottom (24px padding)
- components: card, action_link, cli_snippet

**Feature switchbacks**
- summary: Three dark teal gradient panels stacked 48px apart, each half white-text column and half teal line illustration, alternating sides.
- ground: #FFFFFF (panels #09181B to #0C2A2A gradient)
- desktop: section y 3384-5202, padding 96. Panel 1 y 3480 (492 tall): illustration left (media x 81-898), text right (x 930, 397 wide). Panel 2 y 4020 (576 tall): text left (x 113), illustration right (x 542-1359). Panel 3 y 4644 (462 tall): like panel 1. Text column: eyebrow 33px below the panel top, H3 24px below, body 24px below, list 24px below, rows 58px tall 8px apart.
- phone: Panels 326px wide, 850 / 936 / 826px tall; text first (x 65, 260px wide, H3 24.27/26.7 in 2 lines), illustration below it at 228px wide.
- anatomy:
  - Panel 1 eyebrow "WORKFLOW" / H3 "Prompt. Preview. Repeat." / "Prompt from the dashboard, develop locally, or push from Git. Every change gets a private preview URL before it's live." / rows "Build with Claude, Codex, and more AI agents" (last three words an underlined bold white link), "Deploy from Git, CLI, or drag and drop", "Roll back any deploy in one click" / illustration switchback-1 (code editor with framework badges)
  - Panel 2 eyebrow "PLATFORM" / H3 "Build with agent-ready primitives." / "Add APIs, run logic at the edge, schedule jobs, and handle background work on production infrastructure." / rows "Build APIs with serverless functions", "Add instant databases and file storage", "Handle auth with built-in identity", "Connect to AI models through AI Gateway" / link "Explore the platform" (white w700 underlined, #32E6E2 arrow) / illustration switchback-2 (browser with chart, lock, tree, plug)
  - Panel 3 eyebrow "SCALE" / H3 "Grow on the same infrastructure." / "From your first deploy to global traffic, the same infrastructure supports your growth as you scale." / rows "Automatic HTTPS and DDoS protection", "Manage access, secrets, and env vars by team", "Global edge network with 99.99% uptime" / illustration switchback-3 (two gauges with clouds and birds)
  - Eyebrow Martian Mono 14 uppercase #32E6E2; H3 Figtree 32/35.2 w800 #FFFFFF; body Instrument Sans 16/24 #FFFFFF
  - Illustrations are single-weight Teal 200 #32E6E2 hand-drawn line art on transparent, centred in the 817px media column with 48px padding; no fill, no second colour
- components: switchback_panel, feature_row, action_link

**Testimonial**
- summary: One big pull quote, left aligned, with hanging Blue 700 curly quotes and a two-line mono attribution. No photo, no card.
- ground: #FFFFFF
- desktop: section y 5202-5549, padding 96. Blockquote x 96 (text-indent -0.45em so the open quote hangs left of the text edge), 1264px wide, 2 lines: "I can push a change, and within 30 seconds the site is" / "completely rebuilt." Attribution 16px below.
- phone: Blockquote x 48, 310px wide, 32.55/35.8 in 4 lines; attribution title wraps to 2 lines.
- anatomy:
  - Quote: "I can push a change, and within 30 seconds the site is completely rebuilt." Figtree 48/52.8 w700 #181A1C, quote marks #2E51ED
  - Attribution: "JEFFREY SICA" Martian Mono 14/15.4 uppercase #353A3E, then "KUBERNETES CONTRIBUTOR, HEAD OF PROJECTS AT CNCF" in #778089 directly under it (3px gap)
- components: quote type

**Use cases**
- summary: Left-aligned heading block, a five-tab strip, and a split panel: product copy left, a real code example on near-black right.
- ground: #FFFFFF
- desktop: section y 5549-6690 (shares padding with the stats row). Eyebrow "USE CASES" y 5645; H2 "For every kind of web app." y 5685 (1 line); lead y 5779. Tabs y 5870 (5 x 257x45). Panel y 5915-6497 (1280x582): left half white with padding 48 (H3 y 5964, body y 6058, 3 check rows from y 6154 at 40px pitch, button y 6282); right half #060B10 code.
- phone: Tabs keep their natural widths (125-189px) and scroll sideways; panel stacks body (padding 48) above code; code heading wraps to 2 lines.
- anatomy:
  - Lead: "Build everything from marketing sites to AI apps on one platform."
  - Tab "AI apps" (active): H3 "Launch AI features with one gateway" / "Prototype, test, and scale AI-powered experiences faster. Product teams can iterate with agents while engineers productionize on the same platform." / checks "Prototype and ship AI features with Agent Runners", "Connect your app to any major AI model through AI Gateway", "Deploy backend logic as API endpoints with Serverless Functions" / button "Explore AI Gateway" / code heading "EXAMPLE: GENERATE ALT TEXT WITH OPENAI"
  - Tab "Marketing sites": "Launch fast and iterate faster" / "Run campaigns quickly, test changes safely, and let marketers and designers contribute directly with agents." / "Generate pages, update copy, and publish with Agent Runners", "Review every change before it goes live with Deploy Previews", "Optimize and serve images on demand with Image CDN" / "Marketing sites on Netlify" / "Example: Optimized image with form"
  - Tab "SaaS apps": "Build fullstack apps without managing infrastructure" / "Prototype features quickly with agents and move them into production-ready code as you scale." / "Scaffold and iterate on features with Agent Runners", "Deploy and safely iterate on managed Postgres with Netlify Database", "Scale your backend logic without managing servers with Serverless Functions" / "Explore platform primitives" / "Example: Persist user-generated uploads"
  - Tab "Ecommerce": "Run fast storefronts at global scale" / "Test new experiences quickly and let teams iterate safely across merchandising, design, and engineering." / "Prototype landing pages and flows with Agent Runners", "Deliver sub-second page loads from 100+ locations with Edge Network", "Optimize product images on the fly with Image CDN" / "Ecommerce on Netlify" / "Example: Fetch products from a headless API"
  - Tab "Internal tools": "Create internal apps with less overhead" / "Build dashboards and workflow tools faster with contributions from ops, data, and product teams." / "Build and update internal tools from the dashboard with Agent Runners", "Connect to internal APIs and databases with Serverless Functions", "Manage permissions across your team with Access Controls" / "Internal apps on Netlify" / "Example: Proxy an internal API"
  - Panel H3 Figtree 32/35.2 w800 #353A3E; body 16/24 #353A3E; product names w600; code Martian Mono 16/24 with keywords #89DDFF, const/async/=> #C792EA, strings #ADD7FF, calls #5FB3FF, identifiers #E4F0FB, params #5DE4C7, types #7FDBCA
- components: tab, tab_panel, check_item, button_primary

**Stats row**
- summary: Three inline stats centred under the tabs; the last band before the footer.
- ground: #FFFFFF
- desktop: y 6561 (64px below the panel), one 33px row centred: "10M+ developers" x 401, "60M+ apps deployed" x 620, "99.99% uptime" x 870; 48px between stats; 96px to the footer
- phone: stacked, one stat per row centred, 74px pitch (y 9383, 9457, 9531); value 24.27/24.27
- anatomy:
  - Value Figtree 32/32 w700 #181A1C, label Instrument Sans 16/24 #353A3E 8px after it on the same line
  - No dividers, no icons, no card
- components: stat

**Footer**
- summary: Light footer on white: monogram and social icons on one row, four link columns, a centred newsletter form, then a hairline legal row with copyright and a theme switcher.
- ground: #FFFFFF
- anatomy:
  - y 6786-7502 (716px), content x 120-1320; no top border, no dark ground
  - Row 1: full-colour monogram 50x44 (Teal 400 sparks) at x 120; seven social icons 20px #7E8792 right-aligned ending x 1320, 24px apart: GitHub, LinkedIn, Bluesky, X (formerly known as Twitter), YouTube, Discourse, Discord
  - Columns at y 6884, x 220 / 482 / 744 / 1006 (214px wide): heading Instrument Sans 16/24 w800 tracking -0.4px #545A61, links 14/21 #545A61 on a 36px pitch starting 43px below the heading top
  - Products: Agent Runners, Deploy Previews, Functions, Observability, Security, Netlify CLI, Enterprise, Pricing
  - Resources: Docs, Status, Changelog, Knowledge Base, Guides, Hire an agency
  - Company: About, Agent experience, Open source, Blog, Customers, Partners, Careers, Press
  - Contact us: Sales, Support, Status, Forums
  - Newsletter centred at y 7264 (x 495-949): "Stay up to date with Netlify news" 16/24 #545A61; "Email*" field 327x42 (1px #778089, radius 4; asterisk #D62740) + "Subscribe" Teal 200 pill 111x42, 16px apart
  - Legal row y 7410: 1px #E9EBED top rule, 16px padding, 14/21 #545A61 links 16px apart: Trust Center, Privacy, GDPR/CCPA, Abuse, Cookie Settings; "© 2026 Netlify" right-aligned; theme select (System, Dark, Light) 101x42 under it at the right
  - No street address or phone number on the homepage or footer
- phone: x 20 margins; monogram 40x35, social icons on the next row; the four columns become closed accordions (73px each, 1px #E9EBED bottom rule, 16px chevron #545A61 at right); newsletter field full width (351px) with Subscribe below; legal links wrap (4 on row 1, Cookie Settings, then © 2026 Netlify), theme select at right

**On dark grounds**
- secondary button: #292F35 pill (white at 9.8% over #12181F) with a #32E6E2 Figtree 700 label; on teal panels there is no secondary button, use an action link
- link: white Instrument Sans 16/24 w700 underlined, #32E6E2 north-east arrow (teal panels); Teal 200 #32E6E2 for links on #12181F
- muted text: #DEFFFE for leads and captions on #12181F; body on teal panels is pure #FFFFFF
- hairline: #DEFFFE at 20% (panel border), #FFFFFF at 20% (list rows), dashed #FFFFFF at 30% (hero frame)
- logo variant: full-colour dark-mode logo (white wordmark, Teal 200 sparks): logo-netlify-small-fullcolor-darkmode.svg

## Components

- **button primary** (observed): face display, fill #32E6E2, text #181A1C, radius pill, height 40, padding x 19, size 16, font size 16, weight 700. Teal 200 pill, 2px border in the fill colour plus padding 10px 17px (19px from edge to label), Figtree 16/16 w700. Label #181A1C on white, #12181F inside the hero. Widths: Sign up 93, Start building 138, Explore AI Gateway 183. No icon, no shadow.
  - hover (observed): fill #8EFBF7, border #8EFBF7, transition background-color 0.2s cubic-bezier(0.33, 1, 0.68, 1), border-color 0.2s cubic-bezier(0.33, 1, 0.68, 1)
  - focus (observed): outline auto 1px #99C8FF, outline offset 4px
- **button secondary** (observed): face display, fill #292F35, text #32E6E2, radius pill, height 40, padding x 19, size 16, font size 16, weight 700. Only on the #12181F hero: fill rgba(255,255,255,0.098) (renders #292F35), transparent 2px border, Teal 200 label. Request a demo is 156px wide, 12px right of the primary.
  - hover (observed): fill rgba(167,255,253,0.15), transition background-color 0.2s cubic-bezier(0.33, 1, 0.68, 1), border-color 0.2s cubic-bezier(0.33, 1, 0.68, 1)
  - focus (observed): outline auto 1px #99C8FF, outline offset 4px
- **agent command button** (observed): face mono, fill #292F35, text #32E6E2, radius pill, height 40, padding x 17, size 12, font size 12, weight 700. Hero copy-command pill 306x40: chevron-right 8x13 #32E6E2, "fetch https://netlify.ai" Martian Mono 12/12 w700, 16px copy icon at the right. Caption above it: "Add Netlify to your coding agent" Instrument Sans 14/21 #DEFFFE, centred over the pill, 8px gap. A dot sweep crosses it once on load (animation only); at rest there are no dots.
- **subscribe button** (observed): face display, fill #32E6E2, text #181A1C, radius pill, height 42, padding x 19, size 16, font size 16, weight 700. Footer newsletter submit, 111x42, label "Subscribe".
- **nav link** (observed): face display, text #353A3E, size 16, weight 600, height 40, padding x 12. Figtree 16/24 w600, padding 8px 12px; menu triggers carry a 13px chevron-down 6px after the label. No hover colour change.
- **action link** (observed): face body, text #353A3E, size 16, weight 500. Label underlined (decoration colour #2E51ED, offset 0.1em), then a 14x14 north-east arrow stroked #2E51ED (1.56px, square caps) 2px after. On teal panels: white label w700, arrow #32E6E2. On hover the arrow flicks out to the top-right and back in (0.35s cubic-bezier(.85,0,.15,1)).
- **card** (observed): fill #FFFFFF, ring #E9EBED, ring px 1, radius 6, padding 24. White card, 1px #E9EBED border, radius 6, padding 24, no shadow, no hover change. Inside: 24px Blue 700 icon, 30px gap, headline Figtree 32/35.2 w700, 24px gap, body 16/24, then the action link pinned to the card bottom.
- **step tile** (observed): fill #0C2A2A, radius 16. How-it-works illustration tile 411x274 (3:2), radius 16, Teal 900 ground; drawn product UI in #014847 fields with #14D8D4 1.5px outlines and #DEFFFE text.
- **switchback panel** (observed): radius 6, ring #DEFFFE, ring px 1. 1280px panel, linear-gradient(248deg, #09181B 8.17%, #0C2A2A 56.72%) (101deg when the text column is on the left), 1px border #DEFFFE at 20%, radius 6, overflow hidden. Media column 817px with 48px padding, illustration centred; text column 461px with 32px padding.
- **feature row** (observed): fill rgba(233,235,237,0.1), text #FFFFFF, radius 4, height 58, padding 16. List row on teal panels: 397x58, fill #E9EBED at 10%, 1px border #FFFFFF at 20%, radius 4, padding 16, Instrument Sans 16/24 white; 8px between rows. Product names inside are underlined bold links.
- **tab** (observed): face display, text #353A3E, size 18, weight 600, height 45, padding x 16. Equal-width tabs (257px each at 1440), padding 12px 16px, 18px line icon 12px before the label, white fill, 1px #E9EBED border on top/left/right, neighbours overlap by 1px. Active: label and icon #2E51ED, border #2E51ED, radius 4px 4px 0 0, joins the panel below.
- **tab panel** (observed): ring #2E51ED, ring px 1, radius 6. Bottom corners only (radius 0 0 6px 6px). 1280x582, 1px #2E51ED border; two 639px halves separated by a 1px #2E51ED rule. Left: white, padding 48. Right: #060B10 code panel with a 49px heading strip (Martian Mono 16/24 uppercase #9DA7B2, padding 12, 1px #2E51ED bottom rule), code Martian Mono 16/24 starting 27px below, copy icon 16px #9DA7B2 top right.
- **check item** (observed): . Tab-panel bullet: 16px hand-drawn check mark in #2E51ED (CSS mask), 6px before the text; product name in Instrument Sans 600.
- **cli snippet** (observed): fill #F6F6F7, radius 6. 321x54 box inside a card: 1px border #353A3E at 12%, ground #353A3E at 6%, padding 4px 8px; code Martian Mono 12/18 #353A3E on #F6F6F7; 14px copy icon at right.
- **eyebrow** (observed): face mono, size 14, weight 400, text #2E51ED. Martian Mono 14/15.4 uppercase, 1-2 words; #32E6E2 on teal panels.
- **stat** (observed): . Value Figtree 32/32 w700 #181A1C then label Instrument Sans 16/24 #353A3E on the same baseline, 8px apart; stats 48px apart, the row centred.
- **input** (observed): fill #FFFFFF, ring #778089, ring px 1, radius 4, height 42. Newsletter email field 327x42, padding 8, label "Email" with a #D62740 asterisk.

## Motion tokens

| Name | Easing | Duration | Use | Label |
|---|---|---|---|---|
| fast | ease | 100ms | Small hovers and toggles (--ntl-motion-duration-fast) | observed |
| base | ease | 200ms | Default transition (--ntl-motion-duration-base, --ntl-motion-easing-default) | observed |
| slow | ease | 300ms | Panels and menus (--ntl-motion-duration-slow) | observed |
| slower | ease | 500ms | Large reveals (--ntl-motion-duration-slower) | observed |
| spring | cubic-bezier(.34, 1.56, .64, 1) |  | Playful overshoot (--ntl-motion-easing-spring). The guide publishes no motion; it names animated intros as a full-logo-large use (p.12) | observed |

## Icon tokens

Grid not published, stroke not published (observed).

## Signature moves

### The spark

Where: The logo on every surface; never a background, never a builder for other words.
Do: Short rounded bars converging on the lowercase wordmark (or the "n"): Teal 400 sparks with Teal 800 type on light; Teal 200 sparks with white type on dark; all-white on gradients and photos. The spark "represents the convergence of the technologies and people behind every web experience".
Don't: Modify the logo or add words under it; spell words with the monogram; use the logo as a background graphic (p.18).

### Mind the Gap

Where: Every text/background pair in brand and UI design.
Do: Each ramp runs 000-900 on one shared lightness scale; text and ground must sit at least 500 steps apart (Teal 200 on 800 = 600; Red 700 on Red 000 = 700). Neutral 400 on 000 (400 gap) fails.
Don't: Pair colours fewer than 500 steps apart; disabled-looking grey text on white.
Example: "Teal 200 on Teal 800: a 600-step gap".

### Mono eyebrow over a Figtree head

Where: Above every section head on the site; guide labels and swatch captions.
Do: Martian Mono 400, 14px, uppercase: Blue 700 on light, Teal 200 on dark; then a Figtree 800 head. The guide itself labels figures in small uppercase grey mono (pp.11, 12, 13, 17).
Don't: Sentence-case eyebrows or eyebrows in Figtree.

### Hanging quote mark

Where: Pull quotes (home testimonial, customer stories).
Do: Align the quote's left edge with nearby text and hang the opening quotation mark in the left margin (p.29). Site: Figtree 700 48/52.8 in Neutral 800 with Blue 700 curly quote marks; attribution below in Martian Mono uppercase, name in Neutral 800, title in Neutral 500.
Don't: Indent the whole quote to fit the mark; set attribution in Figtree body style.
Example: "“Ship the change, not the ceremony.”", with "“", "”" set as color.

### Teal line drawings on deep teal

Where: Home switchback panels (workflow, platform, scale); the hero uses the same hand-drawn style in white on #12181F with the orange star mascot.
Do: Hand-drawn, wobbly single-weight outline illustrations (browsers, charts, gauges, clouds, plugs) in Teal 200 #32E6E2 on a Teal 900 gradient panel; the hero star mascot is Gold 300/400 with a Teal 200 wand-star.
Don't: Filled or 3D illustration, stock icons in these panels, colours outside Teal 200/white plus the gold star.

### Glow gradients with dot grids

Where: Promo, webinar and partner graphics in the guide; the OG image.
Do: Deep Blue 900/Purple grounds lit by soft blurred blobs of Blue 700, Teal 200 and Purple (the guide's embedded blob images), with small square dot-grid patches in corners; white Figtree heads, Teal 200 CTA. Purple 800 is the colour that blends Blue and Teal gradients (p.22).
Don't: Purple as a flat solid where Blue could serve; Green anywhere in brand design.

## Voice: rules

The guide publishes no tone-of-voice rules. Its Brand Story (vision, mission, values) gives the substance. Site copy is short, declarative and builder-to-builder.

Why it works: Developers skim; "get right to the point" (p.32).

|  |  |
|---|---|
| Heads | sentence case, period at end (site) |
| Eyebrows | mono caps, 1-2 words |
| CTAs | verb first: Start building, Request a demo |

- Lead with the most important line, large; de-emphasise details, captions and explanations by making them meaningfully smaller. Don't make all text as large as possible.
- Keep text under 65 characters per line; if a block runs longer, set it in multiple columns.
- Make people think "it just works"; simple solutions to complex problems.
- Section heads are short sentence-case statements that end in a period; the hero H1 has none.
- Three one-word imperatives as a head.
- CTAs are short verb phrases; text links end with a north-east arrow.
- Every section opens with a one- or two-word uppercase mono eyebrow.
- Observed on Netlify's live posts: announcement heads are plain statements of what changed ("<Thing> is now available in AI Gateway and Agent Runners", "Ship to Netlify from inside Antigravity"), the line under them says what to do, and a customer-story head closes with the result ("... built its own survey app with prompts").
- Don't set a wall of text (p.32)
- Don't make every line as large as possible (p.32)

Do and don't:
- Do: "Start your way.". Homepage section head: short, sentence case, ends in a period.
- Don't: "Start Your Journey With Netlify Today!". Title Case, padding words and an exclamation mark.
- Do: "Netlify CLI now stores your token in the OS keychain". Changelog card: the head names exactly what changed.
- Don't: "Exciting news: a game-changing upgrade for developers". Hype words with no change named.
- Do: "Auto-deploy on every push. Every PR gets a preview URL.". Deploy from Git card: what happens, in plain product nouns.
- Don't: "Seamlessly accelerate your deployment workflows". Abstract verbs that never say what the product does.

Real examples, to look at on Netlify's own pages (not for reuse):
- Vision: "Build a better web" in Blue 700 with three short supporting points: guide.pdf p.5
- Values: four heads with three bullet points each: guide.pdf p.7
- Homepage "Start your way." cards: a period head, one plain line each, verb-first links (Build now, Import a project): https://www.netlify.com/
- Bluesky announcement card, Nov 10 2026: mono FOR HR TEAMS eyebrow, a head that says what you can now do: https://bsky.app/profile/netlify.com/post/3mzxtjd73l22y

Sources: guide.pdf p.5, p.6, p.7, p.32, https://www.netlify.com/

## Logo: rules

One logo, the Netlify spark, in four lockups. They are full logo large, full logo small (optimised for weight and legibility at each scale), monogram ("n" with sparks) and encapsulated (monogram knocked out of a rounded diamond). Each comes in a light-ground set (Teal 800 type, Teal 400 sparks), a dark-ground set (white type, Teal 200 sparks) and an all-white set. The site header uses the small full-colour logo on white.

Why it works: Weight-tuned large and small cuts keep the thin spark bars legible from buttons to billboards; the colour sets exist so the sparks always have contrast.

|  |  |
|---|---|
| Lockups | Full large, full small, monogram, encapsulated |
| Light set | Type Teal 800 #014847, sparks Teal 400 #05BDBA |
| Dark set | Type white, sparks Teal 200 #32E6E2 |
| Encapsulated (light) | Teal 800 diamond, Teal 200 sparks, white n |
| Full small min | 50px tall digital |
| Full large min | 1.5 in wide at 18 in viewing |
| Monogram min | 1 in print, 50px digital |
| Encapsulated min | not published |
| Clear space | not published |
| White-logo contrast | APCA 60+ vs lightest ground sample |

- Full logo large: when the logo is the centre of attention (t-shirts, event banners, animated intros); min width 1.5 in at 18 in viewing distance, or 1 ft max viewing distance per inch of width (p.12)
- Full logo small: when the logo shares space (site nav, paid ads, email headers); min 50px tall on digital (p.12)
- Monogram only when the full logo won't work: collapsed left-nav UI, a baseball hat; min 1 in printed, 50px tall digital (p.13)
- Encapsulated when the ground is too busy for the monogram, or beside other logos in a logo garden or directory (p.13)
- Light set: ground no darker than the 100-level colours (p.14)
- Dark full-colour set: only on Teal 900/800/700 or Neutral 800/700/600, or a gradient/pattern made of those (p.15)
- All-white set: medium-to-dark non-solid grounds (gradients, photos, patterns); sample the lightest value and check APCA 60+ against white (p.16)
- Cobranding: equal prominence and optical size, enough space that the logos don't read as one brand; get the partner's current logo from their site, never a blurry one (p.17)
- Don't modify the logo or set text into it (p.18)
- Don't create words with the monogram (p.18)
- Don't use the logo as a background or cropped super-graphic (p.18)
- Don't put the light set on a ground darker than the 100 level, or on a busy photo (p.14)
- Don't put the dark full-colour set on Teal 400-like or other unlisted solids, or on a photo (p.15)
- Don't put the white logo on an image too busy to read it; add a gradient or overlay instead (p.16)

Real examples, to look at on Netlify's own pages (not for reuse):
- Logo system grid: full large, full small, monogram, encapsulated on white and Neutral 800: guide.pdf p.11
- Full logo large on a white t-shirt: guide.pdf p.12
- Full logo small on Teal 900 banner ads with Teal 200 "Get started" buttons: guide.pdf p.12
- Monogram embroidered on a black cap (white "n", teal sparks): guide.pdf p.13
- Encapsulated logo in a logo garden of partner app icons: guide.pdf p.13
- Light set with do/don't: blue-200 ground (don't), busy photo (don't), calm photo (do): guide.pdf p.14
- Dark set on Teal 900 with the six permitted dark grounds: guide.pdf p.15
- All-white set on a blue gradient; overlay on a busy photo (do): guide.pdf p.16
- Cobranding: Netlify | Auth0 lockup with a 1px divider on a white card over Teal 600; second card on a purple-blue gradient: guide.pdf p.17
- Things to avoid: "Hula Hoop Champ" added text, a word spelled with the monogram, logo as background on a red OG card: guide.pdf p.18

Sources: guide.pdf p.10, p.11, p.12, p.13, p.14, p.15, p.16, p.17, p.18, https://www.netlify.com/about/#brand-assets, https://www.netlify.com/assets/logos/netlify-logo-full.zip, https://www.netlify.com/assets/logos/netlify-logo-monogram.zip, https://www.netlify.com/assets/logos/netlify-logo-encapsulated.zip

## Color: rules

Teal is the cornerstone and Blue 700 the single accent. The primary palette is Teal (mostly in the logo), a black-like Neutral 800 with true white for text, and Blue 700 as the single accent; five secondary hues (Purple, Red, Gold, Pink, Green) each with one job in brand design and another in UI. Every family is a 10-step ramp (000-900) on one shared lightness scale, which powers the Mind the Gap contrast rule. The site follows it: white pages, Neutral 700/800 text, Blue 700 eyebrows and links, Teal 200 CTAs, dark #12181F and Teal 900 bands.

Why it works: One lightness scale across hues lets anyone pick an accessible pair by arithmetic (500 steps apart) instead of a contrast checker; teal stays special by staying scarce.

|  |  |
|---|---|
| Teal 800 / 400 / 200 | #014847 / #05BDBA / #32E6E2 |
| Neutral 800 / 000 | #181A1C / #FFFFFF |
| Blue 700 | #2E51ED |
| Purple 800 | #382AA4 |
| Red 500 | #FE4E5C |
| Gold 300 | #FBB13D |
| Pink 700 | #9A2D99 |
| Green 400 | #3AC364 |
| Numbering | 000 (lightest) to 900; same number = same lightness across hues |
| Contrast rule | >= 500-step gap; APCA scores printed per swatch |
| Blue 800, Purple 100 | blank in the guide; site tokens #2036A1, #E2D9F7 |

- Teal is the main brand colour but should be used sparingly outside the logo (p.20)
- Only Neutral 800 and Neutral 000 for static text such as headlines and body (p.20)
- Blue 700 for emphasis against the neutrals (p.20)
- Use the expanded ramps for dimensional designs, illustrations, gradients and graphics when the core colours aren't enough (p.21)
- Use the secondary palette sparingly, each colour for its stated purpose (p.22)
- Text and background must be 500 or more steps apart, any family including neutrals (p.24)
- Proportions: none published numerically; the guide says teal and the secondaries are used sparingly, neutrals carry text
- Don't use true black #000000 in place of Neutral 800 (p.20)
- Don't use Purple as a solid ground where Blue could serve (p.22)
- Don't use too much Gold, which "veers off brand" (p.22)
- Don't use Green in brand design; it is for UI success only (p.22)
- Don't pair text and ground fewer than 500 steps apart, e.g. Neutral 400 on 000 (p.24)

Real examples, to look at on Netlify's own pages (not for reuse):
- Primary colours: Teal 800/400/200 logo values, Neutral 800/000, Blue 700: guide.pdf p.20
- Expanded primary ramps with APCA scores: guide.pdf p.21
- Secondary colours with brand and UI roles, beside a dark "Modern Web ROI" promo and a persona grid: guide.pdf p.22
- Expanded secondary ramps: guide.pdf p.23
- Mind the Gap: 500-point rule with compliant Teal buttons and a Red error banner: guide.pdf p.24
- Section divider: full-bleed Blue 700 with white Figtree head and mono label: guide.pdf p.4

Sources: guide.pdf p.19, p.20, p.21, p.22, p.23, p.24, computed styles and CSS tokens (--ntl-*) on https://www.netlify.com/, headless Chromium 2026-11-17

## Typography: rules

Three open Google faces. Figtree (geometric, friendly) for heads, Instrument Sans for body, Martian Mono for code, labels and attribution. The guide publishes an Ideal Stack at 1440 and a responsive scale for desktop, tablet and mobile. The live site sets heads heavier (800) than the guide's Bold and at normal tracking; eyebrows are uppercase mono.

Why it works: A rounded geometric head face echoes the logo's rounded lowercase; a mono third face signals a developer product and carries the labels.

|  |  |
|---|---|
| Display | Figtree, Bold ("680") / Medium ("350") in the guide; site 800/700 |
| Body | Instrument Sans 400 16/24 |
| Mono | Martian Mono 400 (eyebrows 14px caps) |
| Tracking | Guide -2% on Figtree; site computes normal |
| Desktop scale | 64 / 56 / 48 / 32 / 24 / 18 / 16 |
| Mobile scale | 28 / 26 / 22 / 20 / 18 / 18 / 16 |
| Site H1 | Figtree 800 64/70.4 |
| Site section head | Figtree 800 64/70.4 (32/35.2 in panels) |
| Site card head | Figtree 700 24/26.4 |
| Line height tokens | heading 1.1, text 1.5, snug 1.35, relaxed 1.65 |
| Fluid tokens | display-2xl clamp(40px, ..., 64px); display-lg clamp(32px, ..., 48px); display-sm clamp(24px, ..., 32px) |

- Headings: Figtree Bold for primary heads; Bold or Medium for secondary and subheads (p.26)
- Set Figtree to -2% letter spacing everywhere (p.26)
- Body: Instrument Sans; Extra Bold for paragraph headers, Bold for text buttons (p.27)
- Code blocks always Martian Mono; mono also for attribution, distinct from quotes and callouts in Figtree (p.28)
- Text labels: Instrument Sans Medium 500 uppercase; code: Martian Mono Regular 400; quote text Figtree Regular; quote attribution Figtree Semibold uppercase (p.29)
- Pull quotes: align the left edge with nearby text and hang the opening quotation mark in the margin (p.29)
- Ideal Stack @1440: Size 5 Figtree 64; Size 4 48; Size 3 32 Bold or Medium; Size 2 24 Bold or Medium; Section header (Size 1) 21; paragraph intro Instrument Sans 400 18; paragraph 400 16 and 800 16 (p.30)
- Scale by screen (desktop 1440 / tablet 980 / mobile 400): Size 5 64/56/28; Size 4 56/42/26; Size 3 48/34/22; Size 2 32/26/20; Size 1 24/20/18; intro 18; paragraph 16 (p.31); use a fluid (Utopia-style) scale in practice
- No more than 65 characters per line (p.30)
- Don't make all text as large as possible (p.32)
- Don't set code or attributions in Figtree
- Don't exceed 65 characters per line

Real examples, to look at on Netlify's own pages (not for reuse):
- Figtree specimen and "Customer Stories" heading example: guide.pdf p.26
- Instrument Sans specimen with a two-column body example: guide.pdf p.27
- Martian Mono specimen: CLI code block and mono attribution: guide.pdf p.28
- Style exceptions: text label, code, quote, attribution; hanging quote mark: guide.pdf p.29
- Ideal Stack at 1440px: guide.pdf p.30
- Type scale for desktop, tablet and mobile: guide.pdf p.31
- Site pull quote: Figtree 700 48px, Blue 700 hanging quote marks, mono attribution: https://www.netlify.com/

Sources: guide.pdf p.25, p.26, p.27, p.28, p.29, p.30, p.31, computed styles and CSS tokens (--ntl-*) on https://www.netlify.com/, headless Chromium 2026-11-17, https://www.netlify.com/_astro/ (woff2 files)

## Graphic elements: rules

The guide shows its graphic elements but does not specify them. It shows soft glow gradients (blurred blobs of Blue, Teal and Purple) on deep blue grounds, square dot-grid patches, white cards with soft drop shadows, Teal 200 rounded CTA buttons, Blue 000 spread grounds. On the site: hairline-bordered white cards, dark Teal 900 gradient panels with translucent list rows, a dashed rounded frame around the hero illustration, a tabbed code panel with a Blue 700 border and a #060B10 code ground.

Why it works: Dark glowing grounds and code-like details read as a developer platform; white cards keep marketing pages light.

|  |  |
|---|---|
| Glow blobs | Blurred Blue 700, Teal 200 and Purple shapes (guide images img-032-176..190) |
| Dot grid | Small square dots in tight grids, corners of promo cards (pp.17, 32) |
| Panel gradient (site) | linear-gradient(248deg, #09181B 8%, #0C2A2A 57%) |
| Card border (site) | 1px Neutral 200 #E9EBED, hover Neutral 300 |
| Radii (site) | 2/4/6/12/16/30px, pill 360px |
| Shadows (site) | light: 0 2px 4px #33373b14, 0 1px 10px #33373b0f |

- Gradients may blend Purple with Blue and Teal (p.22)
- Logo on gradients/patterns: dark set if made of permitted solid darks (p.15), else all-white (p.16)
- Keep the hierarchy contrast: big head, smaller sub, small body, one CTA (p.32)
- Don't use the logo or spark as a background element (p.18)
- Don't flat Purple grounds where Blue would do (p.22)

Real examples, to look at on Netlify's own pages (not for reuse):
- Promo cards: purple-blue glow gradient, corner dot grids, Teal 200 button; webinar card with speaker photos: guide.pdf p.32
- Modern Web ROI promo: dark ground, glowing UI cards, Teal 200 button: guide.pdf p.22
- Site "How it works": three Teal 900 tiles with product UI, Figtree 700 heads below: https://www.netlify.com/
- Site use-case tabs: Blue 700 bordered tab panel with a dark code block: https://www.netlify.com/

Sources: guide.pdf p.17, p.22, p.32, computed styles and CSS tokens (--ntl-*) on https://www.netlify.com/, headless Chromium 2026-11-17

## Iconography: rules

The guide shows no icon set. On the site: small solid glyph icons in currentColor (Blue 700 on light, Teal 200 on dark), north-east arrows after text links, Blue 700 check marks in feature lists; the OG image uses white line icons in dark circles.

Why it works: Icons stay small and take the link colour, so they mark what is clickable and never compete with the type or the spark (our reading of the site; the guide publishes no icon rules).

|  |  |
|---|---|
| Card icon | 24px solid glyph, Blue 700 #2E51ED |
| Link arrow | 14px, square line caps, currentColor |
| Tab icon | 16px; Blue 700 active, Neutral 700 idle |

- Icons take the link/accent colour: Blue 700 on light, Teal 200 on dark (observed)
- Text links end with a 14px north-east arrow (observed)
- Don't mix filled glyphs and outline icons in one row (observed: card icons are solid, the OG tiles are line icons on dark circles; each surface keeps one style)
- Don't colour icons outside Blue 700 on light and Teal 200 on dark (observed)

Real examples, to look at on Netlify's own pages (not for reuse):
- Start-your-way cards: Blue 700 glyph icons, underlined links with north-east arrows: https://www.netlify.com/
- OG image: white line icons in dark circular tiles: https://www.netlify.com/

Sources: computed styles and CSS tokens (--ntl-*) on https://www.netlify.com/, headless Chromium 2026-11-17

## Illustration: rules

Two families. Guide: flat product-UI illustrations with small blue/teal/orange shapes on white (persona grid, p.22) and glowing UI-card compositions on dark (p.22). Site: hand-drawn wobbly line art (browser windows, charts, plugs, gauges, clouds) in white on #12181F in the hero, in Teal 200 on Teal 900 panels, plus a smiling Gold star mascot with a teal wand-star.

Why it works: The hand-drawn line and the mascot carry the values' "levity and joy" (p.7) into a technical product.

|  |  |
|---|---|
| Line colour | Teal 200 #32E6E2 or white |
| Stroke | single weight, hand-drawn wobble, rounded ends |
| Mascot | Gold 300/400 star, white cloud, Teal 200 star wand |

- Use the expanded ramps for illustrations (p.21)
- Line art in one colour: white on #12181F, Teal 200 on Teal 900 (observed)
- Star mascot in Gold 300 #FBB13D with Gold 400 #F98E21 shading (observed)
- Don't Green in brand illustration (p.22)

Real examples, to look at on Netlify's own pages (not for reuse):
- Persona grid: flat UI illustrations with Blue, Gold and Red accents: guide.pdf p.22
- Site hero: white hand-drawn browser illustration with the Gold star mascot on #12181F: https://www.netlify.com/
- Workflow panel: Teal 200 line drawing of an editor with agent logos: https://www.netlify.com/
- Platform panel: Teal 200 line drawing of a browser with charts and a plug: https://www.netlify.com/
- Scale panel: Teal 200 gauges and clouds: https://www.netlify.com/

Sources: guide.pdf p.7, p.21, p.22, https://www.netlify.com/ (switchback-1.svg, switchback-2.svg and switchback-3.svg from the site's images folder; the hero illustration is inline SVG in .n-page-hero-graphic)

## Photography: rules

Photography appears only as examples. The guide's photos are candid, warm, shallow-depth-of-field event shots of developers talking and laughing (pp.14, 16), merch mockups (t-shirt, cap) and greyscale speaker headshots on a webinar card (p.32). The site's customer pages use customer logos on brand-colour tiles rather than photos.

Why it works: Real people at real events support "Be Inclusive" and "Care deeply, and have fun".

|  |  |
|---|---|
| Subject | People at developer events, candid |
| Treatment | Natural colour; headshots greyscale on promo cards (p.32) |

- Place the logo only where the photo leaves space and contrast; otherwise add a gradient or overlay (pp.14, 16)
- People on social and video covers are cut out and set in greyscale (sometimes colour circles with teal rings) on a teal ground, each with a dark rounded name tag (observed on Bluesky and YouTube, Oct-Nov 2026)
- Don't put a logo over a busy part of a photo (pp.14, 16)

Real examples, to look at on Netlify's own pages (not for reuse):
- Candid conference photo, people laughing: guide.pdf p.14
- Event photo with space for a logo: guide.pdf p.14
- Live treatment on event posts: greyscale host cutouts on a teal-grain ground, dark rounded name tags: https://bsky.app/profile/netlify.com/post/3n27sh7xexk2d
- Video thumbnail: full-height colour portraits at the edges, dark name tags, wordmark between them: https://www.youtube.com/watch?v=6j2UgcC5mVw

Sources: guide.pdf p.14, p.16, p.32

## Interface and layout: rules

The guide's spreads put text left and figures right. Each has a wide left text column (label + paragraph + Resources buttons), figures right, mono captions; generous white space. Ideal Stack at 1440 with multi-column text past 65 characters. Site: 1280px content (--ntl-page-content-max-width 80rem) with 32px gutters, 96px section padding, centred heading blocks, 2-up cards, alternating text/illustration switchback panels.

Why it works: Get to the point: big head, short copy, white space.

|  |  |
|---|---|
| Content max (site) | 1280px (80rem) |
| Gutter (site) | 32px |
| Section padding (site) | 96px top and bottom |
| Space scale (site) | 4, 8, 12, 16, 24, 32, 48, 64, 96, 160px |
| Grid | not published in the guide |

- Max 65 characters per line; split into columns beyond (p.30)
- Contrast sizes to build hierarchy (p.32)
- Don't walls of text (p.32)

Real examples, to look at on Netlify's own pages (not for reuse):
- Ideal Stack page layout at 1440: guide.pdf p.30
- Three-column resources spread with a Blue 000 centre column: guide.pdf p.34

Sources: guide.pdf p.30, p.32, p.34, computed styles and CSS tokens (--ntl-*) on https://www.netlify.com/, headless Chromium 2026-11-17

## Rules: rules

The guide's hard rules protect legibility. They cover logo colour/ground pairings, minimum sizes, the 500-point contrast gap, Neutral 800 not black, Green out of brand design, and Figtree -2%.

Why it works: Legibility and consistency from buttons to billboards (p.11).

|  |  |
|---|---|

- Match the logo colour set to the ground: light, dark or all-white (pp.14-16)
- Keep each lockup above its minimum size: full logo small 50px tall on screen, monogram 1 in printed (pp.12-13)
- Keep text and ground 500 or more ramp steps apart (p.24)
- Set text in Neutral 800 #181A1C, never true black (p.20)
- Keep Green for UI success states only (p.22)
- Track Figtree at -2% (p.26)
- Keep lines under 65 characters; split longer text into columns (p.30)
- Don't Modify the logo or set text into it (p.18)
- Don't Make words with the monogram (p.18)
- Don't Use the logo as a background or cropped super-graphic (p.18)
- Don't Use true black #000000 (p.20)
- Don't Use Green in brand design (p.22)

Real examples, to look at on Netlify's own pages (not for reuse):
- Things to avoid: guide.pdf p.18

Sources: guide.pdf p.12, p.13, p.14, p.15, p.16, p.18, p.20, p.22, p.24, p.26, p.30

## By format

From the guide's own mockups and www.netlify.com. The guide shows banner ads, promo/webinar cards, cobrand cards, OG cards and merch; it publishes no format specs. Loudness runs 0 (nothing but the essentials) to 5 (the signature moves at full volume).

| Format | Loudness 0–5 | Must appear | What varies |
|---|---|---|---|
| Landing page | 2 | White page under a sticky header (Blue 700 announcement bar + white nav, small full-colour logo, Teal 200 pill "Sign up"); a #12181F hero with a Figtree 800 64px head in #E6ECF2, Instrument Sans 18px #DEFFFE lead, Teal 200 pill primary and #292F35 secondary pill, and a white hand-drawn illustration with the gold star in a dashed frame; a scrolling black logo strip; mono eyebrow + Figtree 800 64px head blocks (left-aligned, one centred); hairline white cards with Blue 700 icons; Teal 900 gradient switchback panels with Teal 200 line art; a hanging-quote testimonial; tabs with a code panel; stats row; light footer. Full anatomy: kit.spec.page. | Hero illustration subject; number of switchbacks; whether a code panel appears. |
| Display banner ad | 2 | Teal 900 ground, small full-colour dark logo top centre, white Figtree head ("Deploy a global scale website in minutes."), small Teal 200 "Get started" button. | Sizes from skyscraper to small square. |
| Webinar / promo card | 2 | Deep blue or purple glow-gradient ground with corner dot grids; small white logo top left; one big white Figtree head, a smaller sub, short body; Teal 200 CTA; strong size contrast. | Speaker headshots (greyscale) and a mono pill tag such as "MODERN WEB SERIES". |
| Cobrand / integration card | 2 | Netlify logo and partner logo at equal optical size, separated by a thin vertical rule, on a white card; caption strip below. | Card on a Teal ground or split with a purple-blue gradient panel holding the white logo. |
| Merch | 2 | Full logo large on t-shirts and banners; monogram on caps. | Garment colour, with the matching logo set. |
| OG image | 2 | Dark navy-to-teal glow ground, white-type full-colour logo top left, two-line white Figtree head, product UI or icon tiles at right. | Headline. |
| Social post | 2 | Product-news card: dark teal ground with a faint perspective grid and sparkles, a circled line icon top left, a Teal 100 "Changelog" pill top right, one two-line white headline starting "<Thing> is now ...", one or two plain lines under it, the monogram small bottom right. No people, no button. | Pill label and icon; headline words; sub of one or two lines; the 1920x1080 dark card (Announcement card, dark) is the same news at slide size. |
| Event post, square | 2 | Dark-to-teal gradient ground with grain, one black "terminal window" title box with a glowing Teal 200 border and Martian Mono bold type, the monogram on a light rounded tile at its top-right corner, the hosts as greyscale cutouts or ringed circles with small dark name tags. No button, no URL on the image. | People layout: 2 to 4 greyscale cutouts along the bottom edge, or ringed circles scattered under the box; one or two text lines in the box (date or subtitle).; HR-style variant: colour circles with teal rings instead of cutouts. |
| Announcement card, dark | 2 | Near-black #181A1C ground, a mono teal caps eyebrow, a two-line white Figtree head, then 2 to 4 dark-teal cards in a row or 2x2 (first or last one teal-bordered), a mono teal URL bottom left and the wordmark bottom right. | Number of cards (2 to 4), card labels in mono caps, three big stat numbers for a customer story. |
| Video thumbnail | 2 | Teal gradient ground, a black mono title box with a glowing teal border across the upper part, the hosts large below it (greyscale cutouts, or colour photos at the edges) with dark name tags, the monogram on a light tile at the title box's top-right corner. | Title one or two lines plus an optional subtitle in the box; one to six people; a guest portrait on each side with the wordmark between. |

## Checks before anything ships

- **Logo**: A supplied spark file in the set that matches the ground: light set on grounds no darker than the 100 level, dark set on the listed Teal or Neutral darks, all-white on gradients and photos (pp.14-16). Never retyped, never a background.
- **Teal stays scarce**: Bright Teal 200/400 lives in the logo sparks and the primary pill; Teal 900 may carry a dark ground, but teal is used sparingly outside the logo (p.20).
- **Text colours**: Static text is Neutral 800 #181A1C or white, never #000000; Blue 700 #2E51ED marks emphasis, eyebrows and links (p.20).
- **Mind the Gap**: Every text and ground pair sits 500 or more ramp steps apart (p.24).
- **Three faces**: Figtree heads, Instrument Sans body, Martian Mono for code, eyebrows and attributions (pp.26-29).
- **Eyebrow then head**: Each section opens with a short uppercase mono eyebrow over a short sentence-case head (observed on netlify.com).
- **Hierarchy**: One big line, the rest meaningfully smaller, lines under 65 characters, one CTA (pp.30, 32).
- **Claims**: Only the numbers Netlify states (10M+ developers, 60M+ apps deployed, 99.99% uptime); no invented metrics.

## Make it your own

Keep the system: color roles and proportions, type, layout, components, the signature moves, the voice traits and rules. Replace everything that is Netlify's own: name and logo, positioning, pillars, proof, taglines, boilerplate and any real line quoted above. kit.json lists these under make_it_yours.

## Not published

- Logo clear space: not published.
- Encapsulated logo minimum size: not published.
- Blue 800 and Purple 100 hex: printed blank in the guide (pp.21, 23); filled from site tokens (#2036A1, #E2D9F7).
- Colour proportions: not published as numbers; only "sparingly" for teal and the secondaries.
- Tone of voice, word list, grammar and naming rules: not published.
- Icon style and icon set: not published (site observation only).
- Illustration style: not published beyond using the expanded ramps (site observation only).
- Photography style and treatment: not published (only example photos).
- Grid, margins, spacing scale and breakpoints: not published (site tokens only).
- Buttons, cards and other components: not published (Facets Design System Figma library is linked but not public).
- Motion: not published (site tokens only).
- Guide resources (Facets Design System library, Grab-n-go templates, Design Tokens) are Figma links not accessible here.
- Contradictions inside the guide: body weight "Medium" (p.27 text) vs Regular 400 in its own stacks (pp.30-31); quote attribution in Martian Mono (p.28) vs Figtree Semibold (p.29); Figtree weights labelled 680/350 rather than standard 700/500.
- Guide vs live site: site heads are Figtree 800 at normal tracking (guide: Bold, -2%); site body text is Neutral 700 #353A3E (guide: only Neutral 800/000 for static text); the site hero ground #12181F is not in the guide palette; the Justin Watts quote is attributed to Loblaws in the guide and TunnelBear on the site.
- Site font files are basic-Latin subsets; accented characters fall back to system fonts.
- linkedin.com: walled, not visited.
- Social: no portrait (1080x1350) posts observed on Bluesky; Instagram and X need sign-in; linkedin.com walled, not visited.
- Library: no standalone texture or gradient files beyond two backgrounds, no hardware or device shots, no 3D objects, no award or press-badge marks, no photography of customers at work (only Netlify team and event photos), and no named product screenshots of the main app UI beyond the vector cards listed; builders should leave those slots out rather than draw them.

Logos and reference images belong to Netlify. Look at them on Netlify's own pages; don't reuse them.
