Overview
HashiCorp's marketing canvas is a near-black ground that serves a multi-product portfolio without ever feeling generic. The dominant surface is {colors.canvas} (pure black) layered with {colors.surface-1} charcoal cards and 1px translucent gray hairlines. The chrome is monochrome — white pill-rounded buttons ({components.button-primary}), white type, gray secondary type — but the system is held together by a palette of per-product accent colors that signal which HashiCorp tool a given section belongs to: Terraform purple, Vault yellow, Consul red, Waypoint cyan, Vagrant blue, Nomad green, Boundary coral.
Display type is hashicorpSans at weights 600/700 with tight line-heights (1.17–1.21); body type is the same family at 500 weight with deliberately relaxed line-heights (1.50–1.71) — the contrast feels editorial, not enterprise-templated. CTAs use small {rounded.md} 8px corners rather than pills, which keeps the system reading as developer-facing rather than consumer-y.
The signature device is the product-card family — each HashiCorp product gets its own colored card variant on the home and infrastructure pages, lifting Terraform into a violet ground, Vault into yellow, Waypoint into cyan. These aren't decorative gradients — they're identity surfaces. A reader scrolling the page can tell which product a section is about from the corner of their eye.
Key Characteristics:
- Black-canvas marketing system:
{colors.canvas} is the surface for hero, body, pricing, comparison tables, and footer alike.
- Per-product color identity: Terraform
{colors.product-terraform}, Vault {colors.product-vault}, Waypoint {colors.product-waypoint}, Vagrant {colors.product-vagrant}, Consul {colors.product-consul}, Nomad {colors.product-nomad}, Boundary {colors.product-boundary} — each with its own button + card variant.
- Display headlines run hashicorpSans 600/700 with line-height 1.17–1.21 (tight); body runs the same family at 500 with 1.50–1.71 (relaxed) — the proportional gap is the brand's voice.
- CTA shape is
{rounded.md} 8px — not a pill — keeping the system reading as developer-tool rather than consumer-app.
- Charcoal surface lift (canvas → surface-1 → surface-2) instead of shadow-driven elevation.
- 1px translucent gray hairlines (
rgba(178,182,189,0.1)) define cards and dividers — the borders are felt more than seen.
- Eyebrow typography (12–13px, 600 weight, 0.6px positive tracking, uppercase) marks every section as a category label.
Colors
Source pages: hashicorp.com/en (home), /en/infrastructure-cloud, /en/products/terraform, /en/pricing, /en/resources?contentType=PDF.
Brand & Accent
- Black ({colors.primary}): The system primary surface. Canvas, footer, comparison tables, hero — all black.
- White ({colors.on-primary}): Inverse text on black; canvas of
button-primary.
- Accent Blue ({colors.accent-blue}): Hyperlinks across the marketing surface.
- Visited Purple ({colors.semantic-visited}): Visited-link state.
Surface
- Canvas ({colors.canvas}): Default page background.
- Surface 1 ({colors.surface-1}): Charcoal one step above canvas — feature cards, pricing cards, resource tiles.
- Surface 2 ({colors.surface-2}): Two steps above — featured pricing card, secondary buttons, hovered product chrome.
- Surface 3 ({colors.surface-3}): Three steps above — small chips, badges, sub-nav backgrounds.
- Hairline ({colors.hairline}): 1px borders on cards and dividers.
- Hairline Soft ({colors.hairline-soft}): Subtler dividers — comparison-table rows.
- Inverse Canvas ({colors.inverse-canvas}): Pure white — used as the surface of
button-primary only.
Text
- Ink ({colors.ink}): All headline and emphasized body type — pure white.
- Ink Muted ({colors.ink-muted}): Secondary type at #b2b6bd — meta info, footer columns.
- Ink Subtle ({colors.ink-subtle}): Tertiary type at #656a76 — form helper text, timestamps, footnotes.
Per-Product Identity (signature)
HashiCorp's marketing isn't held together by a single accent color — it's held together by a system of product-specific accents, each used to mark which tool a section represents.
- Terraform Purple ({colors.product-terraform}): Terraform sections, terraform CTAs, the violet 3D cube on the home hero.
- Terraform Bright ({colors.product-terraform-bright}): Saturated highlight — link emphasis on Terraform pages.
- Vault Yellow ({colors.product-vault}): Vault sections and CTAs.
- Consul Red ({colors.product-consul}): Consul sections.
- Waypoint Cyan ({colors.product-waypoint}): Waypoint sections, deep variant
{colors.product-waypoint-deep} for hover/active.
- Vagrant Blue ({colors.product-vagrant}): Vagrant sections.
- Nomad Green ({colors.product-nomad}): Nomad sections.
- Boundary Coral ({colors.product-boundary}): Boundary sections.
Semantic
- Success ({colors.semantic-success}): Positive states (also reused as Nomad green).
- Warning ({colors.semantic-warning}): Warning states (also Vault yellow).
- Error ({colors.semantic-error}): Error states (also Consul red).
- Amber 100 ({colors.amber-100}): Soft warm highlight — extracted but used sparingly.
- Amber 200 ({colors.amber-200}): Saturated amber for caution badges.
- Blue 7 ({colors.blue-7}): Deep navy used in unified-core gradients.
Typography
Font Family
- hashicorpSans — HashiCorp's proprietary marketing typeface. Geometric, clean, slightly humanist. Fallback stack
__hashicorpSans_Fallback_96f0ca (system font), then -apple-system, BlinkMacSystemFont, Segoe UI, helvetica, arial.
The same family carries display, body, button, and caption — no separate display + body pairing. Hierarchy is carried by weight (500 body / 600 emphasis / 700 display) and by a deliberate line-height contrast (tight on display, relaxed on body).
Hierarchy
| Token |
Size |
Weight |
Line Height |
Letter Spacing |
Use |
{typography.display-xl} |
80px |
700 |
1.17 |
-2.5px |
Largest hero headline |
{typography.display-lg} |
56px |
700 |
1.18 |
-1.6px |
Section opener headlines |
{typography.display-md} |
40px |
600 |
1.19 |
-1.0px |
Sub-section headlines |
{typography.headline} |
28px |
600 |
1.21 |
-0.6px |
Pricing tier titles, CTA banner heading |
{typography.card-title} |
22px |
600 |
1.18 |
-0.4px |
Feature card title |
{typography.subhead} |
20px |
600 |
1.35 |
-0.2px |
Long-form intro paragraphs |
{typography.body-lg} |
18px |
500 |
1.69 |
0 |
Hero subhead, lead body |
{typography.body} |
16px |
500 |
1.50 |
0 |
Default body |
{typography.body-sm} |
14px |
500 |
1.71 |
0 |
Card body, footer columns |
{typography.caption} |
13px |
500 |
1.38 |
0.2px |
Meta, comparison cell labels |
{typography.button} |
14px |
600 |
1.29 |
0 |
Pill / square CTA buttons |
{typography.eyebrow} |
12px |
600 |
1.23 |
0.6px |
Uppercase section eyebrows |
Principles
- Tight on display, relaxed on body. Display sits at line-height 1.17–1.21; body lifts to 1.50–1.71. The size + line-height contrast carries hierarchy.
- Weight hierarchy is small. 500 body / 600 emphasis / 700 display. No light / black extremes — the brand reads as engineered.
- Eyebrow positive-tracked uppercase 12px is the section header. Every meaningful section has one above the headline.
- No mono. Despite being a developer-tools brand, the marketing surface uses no monospace face — code voice is reserved for in-product surfaces.
Note on Font Substitutes
If implementing without hashicorpSans, suitable open-source substitutes include Inter (closest geometric character set), Geist Sans, or IBM Plex Sans. Inter at weights 500 / 600 / 700 closely approximates hashicorpSans's proportions; expect to manually adjust line-heights down by ~0.02 to match.
Layout
Spacing System
- Base unit: 8px (the primary increments are 4 / 8 / 12 / 16 / 24 / 32 / 48).
- Tokens (front matter):
{spacing.hair} 1px · {spacing.xxs} 4px · {spacing.xs} 8px · {spacing.sm} 12px · {spacing.md} 16px · {spacing.lg} 24px · {spacing.xl} 32px · {spacing.xxl} 48px · {spacing.section} 96px.
- Card interior padding:
{spacing.lg} 24px on product cards; {spacing.xl} 32px on pricing cards; {spacing.xxl} 48px on CTA banners.
- Button padding: 10px vertical · 18px horizontal on
{components.button-primary}.
- Universal rhythm constant:
{spacing.section} (96px) vertical gap between major sections.
Grid & Container
- Max content width sits around 1280px with side gutters scaling from
{spacing.xxl} on desktop down to {spacing.lg} on mobile.
- Product card grids are 3-up on desktop, 2-up at tablet, 1-up on mobile.
- Pricing tier grid is 3-up across desktop; comparison table beneath uses fixed-width left column.
- Resource directory (PDF library) uses 4-up dense thumbnail grid.
Whitespace Philosophy
The dark canvas IS the whitespace. Sections separate by surface lift (canvas → surface-1) rather than by gaps in white. Within a section, generous {spacing.xl} 32px gaps separate cards; {spacing.lg} 24px separates rows.
Elevation & Depth
| Level |
Treatment |
Use |
| 0 (flat) |
No shadow, no border |
Canvas-mounted display type, hero, footer |
| 1 (charcoal lift) |
{colors.surface-1} background + 1px rgba(178,182,189,0.1) border |
Default cards, resource tiles, pricing cards |
| 2 (surface-2 lift) |
{colors.surface-2} background + 1px {colors.hairline} border |
Featured pricing card, hovered cards, sub-nav |
| 3 (product chromatic) |
Per-product accent color background — Terraform purple, Vault yellow, Waypoint cyan |
Product showcase cards |
The product chromatic level isn't a "modal lift" — it's an identity device. A Terraform card sits at the same z-plane as a feature-card; the difference is meaning, not depth.
Decorative Depth
- 3D product visuals — isometric purple cubes (Terraform), translucent yellow safes (Vault), and similar product-tinted illustrations sit in the right column of hero sections.
- 1px translucent gray hairlines are the dominant edge — borders are visible without competing.
- No drop shadows on dark. Cards lift via surface change, never shadow.
Shapes
Border Radius Scale
| Token |
Value |
Use |
{rounded.xs} |
4px |
Small chips / badges |
{rounded.sm} |
6px |
Inline tag |
{rounded.md} |
8px |
All CTA buttons, form inputs, list items |
{rounded.lg} |
12px |
Feature cards, product cards, pricing cards |
{rounded.xl} |
16px |
Large illustrative tiles |
{rounded.xxl} |
24px |
CTA banner panels |
{rounded.pill} |
9999px |
Eyebrow-style product pills (small chips) |
{rounded.full} |
9999px |
Avatar circles (rare on marketing) |
Photography & Illustration Geometry
- Product 3D illustrations use full-bleed within their container — no rounded inner mask.
- Logo chips in the customer marquee sit on
{rounded.sm} 6px tiles with 1px hairline.
- Resource thumbnails use
{rounded.lg} 12px corners.
Components
Buttons
button-primary — White rounded-rect CTA. Used as primary CTA on all pages.
- Background
{colors.inverse-canvas}, text {colors.inverse-ink}, type {typography.button}, padding 10px 18px, rounded {rounded.md}.
- Pressed state lives in
button-primary-pressed.
button-secondary — Charcoal rounded-rect. Secondary CTA, "Read docs" / "Talk to sales".
- Background
{colors.surface-2}, text {colors.ink}, type {typography.button}, rounded {rounded.md}, padding 10px 18px.
button-tertiary — Bare ghost button on canvas with text-only treatment.
- Background
{colors.canvas}, text {colors.ink}, type {typography.button}, rounded {rounded.md}, padding 10px 18px.
button-product-terraform — Terraform-tinted CTA on Terraform pages.
- Background
{colors.product-terraform}, text {colors.ink}, type {typography.button}, rounded {rounded.md}, padding 10px 18px.
button-product-vault — Vault-yellow CTA.
- Background
{colors.product-vault}, text {colors.inverse-ink} (yellow needs dark text), type {typography.button}, rounded {rounded.md}, padding 10px 18px.
button-product-waypoint — Waypoint-cyan CTA.
- Background
{colors.product-waypoint}, text {colors.inverse-ink}, type {typography.button}, rounded {rounded.md}, padding 10px 18px.
(Vagrant blue, Nomad green, Consul red, Boundary coral follow the same pattern with their respective {colors.product-*} token.)
Cards & Containers
product-card — Default product showcase card — surface-1 charcoal.
- Background
{colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.lg}, padding 24px.
product-card-terraform — Product card with Terraform purple ground (used as identity surface, not modal elevation).
- Background
{colors.product-terraform}, text {colors.ink}, type {typography.body}, rounded {rounded.lg}, padding 24px.
product-card-vault — Vault-yellow ground.
- Background
{colors.product-vault}, text {colors.inverse-ink}, otherwise identical structure.
product-card-waypoint — Waypoint-cyan ground.
- Background
{colors.product-waypoint}, text {colors.inverse-ink}, otherwise identical structure.
(Other product variants follow the same shape with their respective product token.)
feature-card — Generic feature highlight on surface-1.
- Background
{colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.lg}, padding 24px.
pricing-card — Pricing tier on /en/pricing.
- Background
{colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.lg}, padding 32px.
pricing-card-featured — Recommended tier (visually emphasized via surface lift).
- Background
{colors.surface-2}, otherwise identical structure.
resource-card — PDF / whitepaper / guide tile in the resources directory.
- Background
{colors.surface-1}, text {colors.ink}, type {typography.body-sm}, rounded {rounded.lg}, padding 16px.
Inputs & Forms
text-input + text-input-focused — Form fields on pricing seat-count and contact forms.
- Background
{colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.md}, padding 10px 14px.
- Focused state retains the same surface; the focus ring is a 1px
{colors.accent-blue} outline.
Pills & Chips
product-pill — Small product-name chip used above hero headlines and on resource cards to label which product a piece of content belongs to.
- Background
{colors.surface-1}, text {colors.ink-muted}, type {typography.caption}, rounded {rounded.pill}, padding 4px 10px.
Comparison Table
comparison-row — Single row inside the pricing comparison table.
- Background
{colors.canvas}, text {colors.ink-muted}, type {typography.body-sm}. Row separator is {colors.hairline-soft}.
CTA Banner
cta-banner — Large rounded panel used at the bottom of long-form pages with a closing CTA.
- Background
{colors.surface-1}, text {colors.ink}, type {typography.subhead}, rounded {rounded.xxl}, padding 48px.
Navigation
top-nav — Sticky black bar with HashiCorp logomark left, primary nav links centered, and a button-primary ("Sign up") + button-secondary ("Sign in") pair right.
- Background
{colors.canvas}, text {colors.ink}, type {typography.body-sm}, height 64px.
- Mobile: collapses primary links into a hamburger; the primary CTA remains visible.
Footer
footer — Dense link grid on {colors.canvas} with the wordmark at left and 5–6 columns of caption-sized links.
- Background
{colors.canvas}, text {colors.ink-muted}, type {typography.caption}, padding 64px 32px.
Do's and Don'ts
Do
- Reserve
{colors.canvas} (black) and {colors.surface-1} (charcoal) as the system's two anchor surfaces. Every band of the page is one or the other.
- When introducing a section about a specific HashiCorp product, use that product's
{colors.product-*} token consistently — for the section pill, the CTA button, and (where appropriate) the showcase card background.
- Use
{rounded.md} 8px on CTA buttons; HashiCorp's brand reads as engineered, not consumer.
- Pair tight display line-heights (1.17–1.21) with relaxed body line-heights (1.50–1.71). The contrast IS the brand voice.
- Use the eyebrow typography (
{typography.eyebrow}, uppercase, 0.6px tracking) above every meaningful section.
- Use surface lift (canvas → surface-1 → surface-2) to express hierarchy on dark.
- Reserve product-chromatic cards for product identity; keep generic feature cards on
{colors.surface-1}.
Don't
- Don't ship a light-mode marketing page. HashiCorp's marketing brand IS dark.
- Don't introduce mid-tone gray text outside the documented
ink / ink-muted / ink-subtle set.
- Don't square off CTA corners — use
{rounded.md} 8px, not 0px.
- Don't use a product accent color for a CTA on a page that isn't about that product. Terraform purple on the Vault page is a brand violation.
- Don't combine multiple product accents in the same viewport — the system says "this section is about THIS tool", and mixing accents breaks that signal.
- Don't add drop shadows on dark; surface lift carries elevation.
- Don't replace
hashicorpSans with a display-only sans for headlines and a different family for body. The brand is held together by one family across the full hierarchy.
Responsive Behavior
Breakpoints
| Name |
Width |
Key Changes |
| Desktop-XL |
1440px |
Default desktop layout |
| Desktop |
1280px |
Pricing 3-up grid maintained |
| Tablet |
1024px |
Product card grid 3-up → 2-up |
| Mobile-Lg |
768px |
Pricing comparison becomes per-tier accordion; nav becomes hamburger |
| Mobile |
480px |
Single-column everything; display-xl scales 80px → ~36px |
Touch Targets
- CTA buttons (
button-primary, button-secondary) maintain ≥40px tap height across viewports.
- Product pills are 24px tall on desktop and grow to 28px on touch viewports.
- Form inputs hold ≥44px tap target on touch viewports.
Collapsing Strategy
- Nav: horizontal nav with right-anchored CTAs collapses to a hamburger overlay below 768px. The primary CTA stays visible on the bar.
- Product card grid: 3-up → 2-up at 1024px → 1-up below 768px.
- Pricing comparison table: collapses into per-tier accordions below 768px to avoid horizontal scroll.
- Display type:
{typography.display-xl} 80px scales toward {typography.display-md} 40px on mobile while preserving the negative-tracking percentage.
Image Behavior
- 3D product illustrations (cubes, safes, etc.) maintain aspect ratio and never crop; below 768px they shrink rather than reflow.
- Customer logo marquee scales horizontally and may wrap to a second row at narrow widths.
Iteration Guide
- Focus on ONE component at a time and reference it by its
components: token name.
- When introducing a new section, decide first whether it's a generic feature (surface-1) or a product-identity section (product-* color).
- Default body to
{typography.body} at 500 weight; reach for {typography.subhead} only inside CTA banners and feature cards.
- Run
npx @google/design.md lint DESIGN.md after edits.
- Add new product variants as separate component entries (
product-card-nomad, button-product-consul, etc.).
- Treat the per-product palette as identity tokens, not decoration. If you reach for a product color outside its product context, the brand is drifting.
- Eyebrow type is mandatory above every section — skipping it makes sections read as floating.
Known Gaps
- The exact product-color hex values come from the
--mds-color-* CSS variable set extracted directly; they are HashiCorp's canonical brand spec.
- Shadow tokens are not extensively documented because the dark surface system uses surface lift instead of shadow elevation.
- Form-field error and validation styling is not visible on the inspected pages.
- Dark mode is the only marketing mode — light-mode adaptation is not documented.
- Product-card variants for Consul, Nomad, Vagrant, and Boundary follow the documented Terraform / Vault / Waypoint pattern but are referenced in prose only; if they need formal entries they can be added as
product-card-consul, product-card-nomad, etc.
1---2version: alpha3name: hashicorp-design-analysis4description: "An enterprise-infrastructure marketing canvas built around a near-black ground (#000000) and a system of per-product accent colors — Terraform purple, Vault yellow, Consul pink, Waypoint cyan, Vagrant blue — that act as identity tokens rather than decorative palette. Display type is hashicorpSans set in 600/700 with tight 1.17–1.21 line-heights; body type runs the same family at 500 weight with relaxed 1.50–1.71 line-heights. Cards live as charcoal surfaces with 1px translucent gray borders; product showcase cards lift into per-product chromatic gradients. The system reads as confident, technical, and intentionally multi-product — every section quietly signals which HashiCorp tool it represents."56colors:7 primary: "#000000"8 on-primary: "#ffffff"9 accent-blue: "#2b89ff"10 ink: "#ffffff"11 ink-muted: "#b2b6bd"12 ink-subtle: "#656a76"13 canvas: "#000000"14 surface-1: "#15181e"15 surface-2: "#1f232b"16 surface-3: "#3b3d45"17 hairline: "#3b3d45"18 hairline-soft: "#252830"19 inverse-canvas: "#ffffff"20 inverse-ink: "#000000"21 product-terraform: "#7b42bc"22 product-terraform-bright: "#911ced"23 product-vault: "#ffcf25"24 product-consul: "#e62b1e"25 product-waypoint: "#14c6cb"26 product-waypoint-deep: "#12b6bb"27 product-vagrant: "#1868f2"28 product-nomad: "#00ca8e"29 product-boundary: "#f24c53"30 amber-100: "#fbeabf"31 amber-200: "#bb5a00"32 blue-7: "#101a59"33 semantic-success: "#00ca8e"34 semantic-warning: "#ffcf25"35 semantic-error: "#e62b1e"36 semantic-visited: "#a737ff"3738typography:39 display-xl:40 fontFamily: hashicorpSans41 fontSize: 80px42 fontWeight: 70043 lineHeight: 1.1744 letterSpacing: -2.5px45 display-lg:46 fontFamily: hashicorpSans47 fontSize: 56px48 fontWeight: 70049 lineHeight: 1.1850 letterSpacing: -1.6px51 display-md:52 fontFamily: hashicorpSans53 fontSize: 40px54 fontWeight: 60055 lineHeight: 1.1956 letterSpacing: -1.0px57 headline:58 fontFamily: hashicorpSans59 fontSize: 28px60 fontWeight: 60061 lineHeight: 1.2162 letterSpacing: -0.6px63 card-title:64 fontFamily: hashicorpSans65 fontSize: 22px66 fontWeight: 60067 lineHeight: 1.1868 letterSpacing: -0.4px69 subhead:70 fontFamily: hashicorpSans71 fontSize: 20px72 fontWeight: 60073 lineHeight: 1.3574 letterSpacing: -0.2px75 body-lg:76 fontFamily: hashicorpSans77 fontSize: 18px78 fontWeight: 50079 lineHeight: 1.6980 letterSpacing: 081 body:82 fontFamily: hashicorpSans83 fontSize: 16px84 fontWeight: 50085 lineHeight: 1.5086 letterSpacing: 087 body-sm:88 fontFamily: hashicorpSans89 fontSize: 14px90 fontWeight: 50091 lineHeight: 1.7192 letterSpacing: 093 caption:94 fontFamily: hashicorpSans95 fontSize: 13px96 fontWeight: 50097 lineHeight: 1.3898 letterSpacing: 0.2px99 button:100 fontFamily: hashicorpSans101 fontSize: 14px102 fontWeight: 600103 lineHeight: 1.29104 letterSpacing: 0105 eyebrow:106 fontFamily: hashicorpSans107 fontSize: 12px108 fontWeight: 600109 lineHeight: 1.23110 letterSpacing: 0.6px111112rounded:113 xs: 4px114 sm: 6px115 md: 8px116 lg: 12px117 xl: 16px118 xxl: 24px119 pill: 9999px120 full: 9999px121122spacing:123 hair: 1px124 xxs: 4px125 xs: 8px126 sm: 12px127 md: 16px128 lg: 24px129 xl: 32px130 xxl: 48px131 section: 96px132133components:134 button-primary:135 backgroundColor: "{colors.inverse-canvas}"136 textColor: "{colors.inverse-ink}"137 typography: "{typography.button}"138 rounded: "{rounded.md}"139 padding: 10px 18px140 button-primary-pressed:141 backgroundColor: "{colors.inverse-canvas}"142 textColor: "{colors.inverse-ink}"143 typography: "{typography.button}"144 rounded: "{rounded.md}"145 button-secondary:146 backgroundColor: "{colors.surface-2}"147 textColor: "{colors.ink}"148 typography: "{typography.button}"149 rounded: "{rounded.md}"150 padding: 10px 18px151 button-tertiary:152 backgroundColor: "{colors.canvas}"153 textColor: "{colors.ink}"154 typography: "{typography.button}"155 rounded: "{rounded.md}"156 padding: 10px 18px157 button-product-terraform:158 backgroundColor: "{colors.product-terraform}"159 textColor: "{colors.ink}"160 typography: "{typography.button}"161 rounded: "{rounded.md}"162 padding: 10px 18px163 button-product-vault:164 backgroundColor: "{colors.product-vault}"165 textColor: "{colors.inverse-ink}"166 typography: "{typography.button}"167 rounded: "{rounded.md}"168 padding: 10px 18px169 button-product-waypoint:170 backgroundColor: "{colors.product-waypoint}"171 textColor: "{colors.inverse-ink}"172 typography: "{typography.button}"173 rounded: "{rounded.md}"174 padding: 10px 18px175 product-card:176 backgroundColor: "{colors.surface-1}"177 textColor: "{colors.ink}"178 typography: "{typography.body}"179 rounded: "{rounded.lg}"180 padding: 24px181 product-card-terraform:182 backgroundColor: "{colors.product-terraform}"183 textColor: "{colors.ink}"184 typography: "{typography.body}"185 rounded: "{rounded.lg}"186 padding: 24px187 product-card-vault:188 backgroundColor: "{colors.product-vault}"189 textColor: "{colors.inverse-ink}"190 typography: "{typography.body}"191 rounded: "{rounded.lg}"192 padding: 24px193 product-card-waypoint:194 backgroundColor: "{colors.product-waypoint}"195 textColor: "{colors.inverse-ink}"196 typography: "{typography.body}"197 rounded: "{rounded.lg}"198 padding: 24px199 feature-card:200 backgroundColor: "{colors.surface-1}"201 textColor: "{colors.ink}"202 typography: "{typography.body}"203 rounded: "{rounded.lg}"204 padding: 24px205 pricing-card:206 backgroundColor: "{colors.surface-1}"207 textColor: "{colors.ink}"208 typography: "{typography.body}"209 rounded: "{rounded.lg}"210 padding: 32px211 pricing-card-featured:212 backgroundColor: "{colors.surface-2}"213 textColor: "{colors.ink}"214 typography: "{typography.body}"215 rounded: "{rounded.lg}"216 padding: 32px217 resource-card:218 backgroundColor: "{colors.surface-1}"219 textColor: "{colors.ink}"220 typography: "{typography.body-sm}"221 rounded: "{rounded.lg}"222 padding: 16px223 text-input:224 backgroundColor: "{colors.surface-1}"225 textColor: "{colors.ink}"226 typography: "{typography.body}"227 rounded: "{rounded.md}"228 padding: 10px 14px229 text-input-focused:230 backgroundColor: "{colors.surface-1}"231 textColor: "{colors.ink}"232 typography: "{typography.body}"233 rounded: "{rounded.md}"234 padding: 10px 14px235 product-pill:236 backgroundColor: "{colors.surface-1}"237 textColor: "{colors.ink-muted}"238 typography: "{typography.caption}"239 rounded: "{rounded.pill}"240 padding: 4px 10px241 top-nav:242 backgroundColor: "{colors.canvas}"243 textColor: "{colors.ink}"244 typography: "{typography.body-sm}"245 rounded: "{rounded.xs}"246 height: 64px247 comparison-row:248 backgroundColor: "{colors.canvas}"249 textColor: "{colors.ink-muted}"250 typography: "{typography.body-sm}"251 rounded: "{rounded.xs}"252 cta-banner:253 backgroundColor: "{colors.surface-1}"254 textColor: "{colors.ink}"255 typography: "{typography.subhead}"256 rounded: "{rounded.xxl}"257 padding: 48px258 footer:259 backgroundColor: "{colors.canvas}"260 textColor: "{colors.ink-muted}"261 typography: "{typography.caption}"262 rounded: "{rounded.xs}"263 padding: 64px 32px264metadata:265 source: https://skillmd.com/skills/skillmds/hashicorp-design-analysis266---267268269## Overview270271HashiCorp's marketing canvas is a near-black ground that serves a multi-product portfolio without ever feeling generic. The dominant surface is `{colors.canvas}` (pure black) layered with `{colors.surface-1}` charcoal cards and 1px translucent gray hairlines. The chrome is monochrome — white pill-rounded buttons (`{components.button-primary}`), white type, gray secondary type — but the system is held together by a **palette of per-product accent colors** that signal which HashiCorp tool a given section belongs to: Terraform purple, Vault yellow, Consul red, Waypoint cyan, Vagrant blue, Nomad green, Boundary coral.272273Display type is **hashicorpSans** at weights 600/700 with tight line-heights (1.17–1.21); body type is the same family at 500 weight with deliberately relaxed line-heights (1.50–1.71) — the contrast feels editorial, not enterprise-templated. CTAs use small `{rounded.md}` 8px corners rather than pills, which keeps the system reading as developer-facing rather than consumer-y.274275The signature device is the **product-card** family — each HashiCorp product gets its own colored card variant on the home and infrastructure pages, lifting Terraform into a violet ground, Vault into yellow, Waypoint into cyan. These aren't decorative gradients — they're identity surfaces. A reader scrolling the page can tell which product a section is about from the corner of their eye.276277**Key Characteristics:**278- Black-canvas marketing system: `{colors.canvas}` is the surface for hero, body, pricing, comparison tables, and footer alike.279- **Per-product color identity**: Terraform `{colors.product-terraform}`, Vault `{colors.product-vault}`, Waypoint `{colors.product-waypoint}`, Vagrant `{colors.product-vagrant}`, Consul `{colors.product-consul}`, Nomad `{colors.product-nomad}`, Boundary `{colors.product-boundary}` — each with its own button + card variant.280- Display headlines run hashicorpSans 600/700 with line-height 1.17–1.21 (tight); body runs the same family at 500 with 1.50–1.71 (relaxed) — the proportional gap is the brand's voice.281- CTA shape is `{rounded.md}` 8px — not a pill — keeping the system reading as developer-tool rather than consumer-app.282- Charcoal surface lift (canvas → surface-1 → surface-2) instead of shadow-driven elevation.283- 1px translucent gray hairlines (`rgba(178,182,189,0.1)`) define cards and dividers — the borders are felt more than seen.284- Eyebrow typography (12–13px, 600 weight, 0.6px positive tracking, uppercase) marks every section as a category label.285286## Colors287288> Source pages: hashicorp.com/en (home), /en/infrastructure-cloud, /en/products/terraform, /en/pricing, /en/resources?contentType=PDF.289290### Brand & Accent291- **Black** ({colors.primary}): The system primary surface. Canvas, footer, comparison tables, hero — all black.292- **White** ({colors.on-primary}): Inverse text on black; canvas of `button-primary`.293- **Accent Blue** ({colors.accent-blue}): Hyperlinks across the marketing surface.294- **Visited Purple** ({colors.semantic-visited}): Visited-link state.295296### Surface297- **Canvas** ({colors.canvas}): Default page background.298- **Surface 1** ({colors.surface-1}): Charcoal one step above canvas — feature cards, pricing cards, resource tiles.299- **Surface 2** ({colors.surface-2}): Two steps above — featured pricing card, secondary buttons, hovered product chrome.300- **Surface 3** ({colors.surface-3}): Three steps above — small chips, badges, sub-nav backgrounds.301- **Hairline** ({colors.hairline}): 1px borders on cards and dividers.302- **Hairline Soft** ({colors.hairline-soft}): Subtler dividers — comparison-table rows.303- **Inverse Canvas** ({colors.inverse-canvas}): Pure white — used as the surface of `button-primary` only.304305### Text306- **Ink** ({colors.ink}): All headline and emphasized body type — pure white.307- **Ink Muted** ({colors.ink-muted}): Secondary type at #b2b6bd — meta info, footer columns.308- **Ink Subtle** ({colors.ink-subtle}): Tertiary type at #656a76 — form helper text, timestamps, footnotes.309310### Per-Product Identity (signature)311HashiCorp's marketing isn't held together by a single accent color — it's held together by a system of product-specific accents, each used to mark which tool a section represents.312313- **Terraform Purple** ({colors.product-terraform}): Terraform sections, terraform CTAs, the violet 3D cube on the home hero.314- **Terraform Bright** ({colors.product-terraform-bright}): Saturated highlight — link emphasis on Terraform pages.315- **Vault Yellow** ({colors.product-vault}): Vault sections and CTAs.316- **Consul Red** ({colors.product-consul}): Consul sections.317- **Waypoint Cyan** ({colors.product-waypoint}): Waypoint sections, deep variant `{colors.product-waypoint-deep}` for hover/active.318- **Vagrant Blue** ({colors.product-vagrant}): Vagrant sections.319- **Nomad Green** ({colors.product-nomad}): Nomad sections.320- **Boundary Coral** ({colors.product-boundary}): Boundary sections.321322### Semantic323- **Success** ({colors.semantic-success}): Positive states (also reused as Nomad green).324- **Warning** ({colors.semantic-warning}): Warning states (also Vault yellow).325- **Error** ({colors.semantic-error}): Error states (also Consul red).326- **Amber 100** ({colors.amber-100}): Soft warm highlight — extracted but used sparingly.327- **Amber 200** ({colors.amber-200}): Saturated amber for caution badges.328- **Blue 7** ({colors.blue-7}): Deep navy used in unified-core gradients.329330## Typography331332### Font Family333334- **hashicorpSans** — HashiCorp's proprietary marketing typeface. Geometric, clean, slightly humanist. Fallback stack `__hashicorpSans_Fallback_96f0ca` (system font), then `-apple-system, BlinkMacSystemFont, Segoe UI, helvetica, arial`.335336The same family carries display, body, button, and caption — no separate display + body pairing. Hierarchy is carried by weight (500 body / 600 emphasis / 700 display) and by a deliberate line-height contrast (tight on display, relaxed on body).337338### Hierarchy339340| Token | Size | Weight | Line Height | Letter Spacing | Use |341|---|---|---|---|---|---|342| `{typography.display-xl}` | 80px | 700 | 1.17 | -2.5px | Largest hero headline |343| `{typography.display-lg}` | 56px | 700 | 1.18 | -1.6px | Section opener headlines |344| `{typography.display-md}` | 40px | 600 | 1.19 | -1.0px | Sub-section headlines |345| `{typography.headline}` | 28px | 600 | 1.21 | -0.6px | Pricing tier titles, CTA banner heading |346| `{typography.card-title}` | 22px | 600 | 1.18 | -0.4px | Feature card title |347| `{typography.subhead}` | 20px | 600 | 1.35 | -0.2px | Long-form intro paragraphs |348| `{typography.body-lg}` | 18px | 500 | 1.69 | 0 | Hero subhead, lead body |349| `{typography.body}` | 16px | 500 | 1.50 | 0 | Default body |350| `{typography.body-sm}` | 14px | 500 | 1.71 | 0 | Card body, footer columns |351| `{typography.caption}` | 13px | 500 | 1.38 | 0.2px | Meta, comparison cell labels |352| `{typography.button}` | 14px | 600 | 1.29 | 0 | Pill / square CTA buttons |353| `{typography.eyebrow}` | 12px | 600 | 1.23 | 0.6px | Uppercase section eyebrows |354355### Principles356357- **Tight on display, relaxed on body.** Display sits at line-height 1.17–1.21; body lifts to 1.50–1.71. The size + line-height contrast carries hierarchy.358- **Weight hierarchy is small.** 500 body / 600 emphasis / 700 display. No light / black extremes — the brand reads as engineered.359- **Eyebrow positive-tracked uppercase 12px is the section header.** Every meaningful section has one above the headline.360- **No mono.** Despite being a developer-tools brand, the marketing surface uses no monospace face — code voice is reserved for in-product surfaces.361362### Note on Font Substitutes363364If implementing without hashicorpSans, suitable open-source substitutes include **Inter** (closest geometric character set), **Geist Sans**, or **IBM Plex Sans**. Inter at weights 500 / 600 / 700 closely approximates hashicorpSans's proportions; expect to manually adjust line-heights down by ~0.02 to match.365366## Layout367368### Spacing System369370- **Base unit**: 8px (the primary increments are 4 / 8 / 12 / 16 / 24 / 32 / 48).371- **Tokens (front matter)**: `{spacing.hair}` 1px · `{spacing.xxs}` 4px · `{spacing.xs}` 8px · `{spacing.sm}` 12px · `{spacing.md}` 16px · `{spacing.lg}` 24px · `{spacing.xl}` 32px · `{spacing.xxl}` 48px · `{spacing.section}` 96px.372- Card interior padding: `{spacing.lg}` 24px on product cards; `{spacing.xl}` 32px on pricing cards; `{spacing.xxl}` 48px on CTA banners.373- Button padding: 10px vertical · 18px horizontal on `{components.button-primary}`.374- Universal rhythm constant: `{spacing.section}` (96px) vertical gap between major sections.375376### Grid & Container377378- Max content width sits around 1280px with side gutters scaling from `{spacing.xxl}` on desktop down to `{spacing.lg}` on mobile.379- Product card grids are 3-up on desktop, 2-up at tablet, 1-up on mobile.380- Pricing tier grid is 3-up across desktop; comparison table beneath uses fixed-width left column.381- Resource directory (PDF library) uses 4-up dense thumbnail grid.382383### Whitespace Philosophy384385The dark canvas IS the whitespace. Sections separate by surface lift (canvas → surface-1) rather than by gaps in white. Within a section, generous `{spacing.xl}` 32px gaps separate cards; `{spacing.lg}` 24px separates rows.386387## Elevation & Depth388389| Level | Treatment | Use |390|---|---|---|391| 0 (flat) | No shadow, no border | Canvas-mounted display type, hero, footer |392| 1 (charcoal lift) | `{colors.surface-1}` background + 1px `rgba(178,182,189,0.1)` border | Default cards, resource tiles, pricing cards |393| 2 (surface-2 lift) | `{colors.surface-2}` background + 1px `{colors.hairline}` border | Featured pricing card, hovered cards, sub-nav |394| 3 (product chromatic) | Per-product accent color background — Terraform purple, Vault yellow, Waypoint cyan | Product showcase cards |395396The product chromatic level isn't a "modal lift" — it's an identity device. A Terraform card sits at the same z-plane as a feature-card; the difference is meaning, not depth.397398### Decorative Depth399400- **3D product visuals** — isometric purple cubes (Terraform), translucent yellow safes (Vault), and similar product-tinted illustrations sit in the right column of hero sections.401- **1px translucent gray hairlines** are the dominant edge — borders are visible without competing.402- **No drop shadows on dark.** Cards lift via surface change, never shadow.403404## Shapes405406### Border Radius Scale407408| Token | Value | Use |409|---|---|---|410| `{rounded.xs}` | 4px | Small chips / badges |411| `{rounded.sm}` | 6px | Inline tag |412| `{rounded.md}` | 8px | All CTA buttons, form inputs, list items |413| `{rounded.lg}` | 12px | Feature cards, product cards, pricing cards |414| `{rounded.xl}` | 16px | Large illustrative tiles |415| `{rounded.xxl}` | 24px | CTA banner panels |416| `{rounded.pill}` | 9999px | Eyebrow-style product pills (small chips) |417| `{rounded.full}` | 9999px | Avatar circles (rare on marketing) |418419### Photography & Illustration Geometry420421- Product 3D illustrations use full-bleed within their container — no rounded inner mask.422- Logo chips in the customer marquee sit on `{rounded.sm}` 6px tiles with 1px hairline.423- Resource thumbnails use `{rounded.lg}` 12px corners.424425## Components426427### Buttons428429**`button-primary`** — White rounded-rect CTA. Used as primary CTA on all pages.430- Background `{colors.inverse-canvas}`, text `{colors.inverse-ink}`, type `{typography.button}`, padding 10px 18px, rounded `{rounded.md}`.431- Pressed state lives in `button-primary-pressed`.432433**`button-secondary`** — Charcoal rounded-rect. Secondary CTA, "Read docs" / "Talk to sales".434- Background `{colors.surface-2}`, text `{colors.ink}`, type `{typography.button}`, rounded `{rounded.md}`, padding 10px 18px.435436**`button-tertiary`** — Bare ghost button on canvas with text-only treatment.437- Background `{colors.canvas}`, text `{colors.ink}`, type `{typography.button}`, rounded `{rounded.md}`, padding 10px 18px.438439**`button-product-terraform`** — Terraform-tinted CTA on Terraform pages.440- Background `{colors.product-terraform}`, text `{colors.ink}`, type `{typography.button}`, rounded `{rounded.md}`, padding 10px 18px.441442**`button-product-vault`** — Vault-yellow CTA.443- Background `{colors.product-vault}`, text `{colors.inverse-ink}` (yellow needs dark text), type `{typography.button}`, rounded `{rounded.md}`, padding 10px 18px.444445**`button-product-waypoint`** — Waypoint-cyan CTA.446- Background `{colors.product-waypoint}`, text `{colors.inverse-ink}`, type `{typography.button}`, rounded `{rounded.md}`, padding 10px 18px.447448(Vagrant blue, Nomad green, Consul red, Boundary coral follow the same pattern with their respective `{colors.product-*}` token.)449450### Cards & Containers451452**`product-card`** — Default product showcase card — surface-1 charcoal.453- Background `{colors.surface-1}`, text `{colors.ink}`, type `{typography.body}`, rounded `{rounded.lg}`, padding 24px.454455**`product-card-terraform`** — Product card with Terraform purple ground (used as identity surface, not modal elevation).456- Background `{colors.product-terraform}`, text `{colors.ink}`, type `{typography.body}`, rounded `{rounded.lg}`, padding 24px.457458**`product-card-vault`** — Vault-yellow ground.459- Background `{colors.product-vault}`, text `{colors.inverse-ink}`, otherwise identical structure.460461**`product-card-waypoint`** — Waypoint-cyan ground.462- Background `{colors.product-waypoint}`, text `{colors.inverse-ink}`, otherwise identical structure.463464(Other product variants follow the same shape with their respective product token.)465466**`feature-card`** — Generic feature highlight on surface-1.467- Background `{colors.surface-1}`, text `{colors.ink}`, type `{typography.body}`, rounded `{rounded.lg}`, padding 24px.468469**`pricing-card`** — Pricing tier on `/en/pricing`.470- Background `{colors.surface-1}`, text `{colors.ink}`, type `{typography.body}`, rounded `{rounded.lg}`, padding 32px.471472**`pricing-card-featured`** — Recommended tier (visually emphasized via surface lift).473- Background `{colors.surface-2}`, otherwise identical structure.474475**`resource-card`** — PDF / whitepaper / guide tile in the resources directory.476- Background `{colors.surface-1}`, text `{colors.ink}`, type `{typography.body-sm}`, rounded `{rounded.lg}`, padding 16px.477478### Inputs & Forms479480**`text-input`** + **`text-input-focused`** — Form fields on pricing seat-count and contact forms.481- Background `{colors.surface-1}`, text `{colors.ink}`, type `{typography.body}`, rounded `{rounded.md}`, padding 10px 14px.482- Focused state retains the same surface; the focus ring is a 1px `{colors.accent-blue}` outline.483484### Pills & Chips485486**`product-pill`** — Small product-name chip used above hero headlines and on resource cards to label which product a piece of content belongs to.487- Background `{colors.surface-1}`, text `{colors.ink-muted}`, type `{typography.caption}`, rounded `{rounded.pill}`, padding 4px 10px.488489### Comparison Table490491**`comparison-row`** — Single row inside the pricing comparison table.492- Background `{colors.canvas}`, text `{colors.ink-muted}`, type `{typography.body-sm}`. Row separator is `{colors.hairline-soft}`.493494### CTA Banner495496**`cta-banner`** — Large rounded panel used at the bottom of long-form pages with a closing CTA.497- Background `{colors.surface-1}`, text `{colors.ink}`, type `{typography.subhead}`, rounded `{rounded.xxl}`, padding 48px.498499### Navigation500501**`top-nav`** — Sticky black bar with HashiCorp logomark left, primary nav links centered, and a `button-primary` ("Sign up") + `button-secondary` ("Sign in") pair right.502- Background `{colors.canvas}`, text `{colors.ink}`, type `{typography.body-sm}`, height 64px.503- Mobile: collapses primary links into a hamburger; the primary CTA remains visible.504505### Footer506507**`footer`** — Dense link grid on `{colors.canvas}` with the wordmark at left and 5–6 columns of caption-sized links.508- Background `{colors.canvas}`, text `{colors.ink-muted}`, type `{typography.caption}`, padding 64px 32px.509510## Do's and Don'ts511512### Do513514- Reserve `{colors.canvas}` (black) and `{colors.surface-1}` (charcoal) as the system's two anchor surfaces. Every band of the page is one or the other.515- When introducing a section about a specific HashiCorp product, use that product's `{colors.product-*}` token consistently — for the section pill, the CTA button, and (where appropriate) the showcase card background.516- Use `{rounded.md}` 8px on CTA buttons; HashiCorp's brand reads as engineered, not consumer.517- Pair tight display line-heights (1.17–1.21) with relaxed body line-heights (1.50–1.71). The contrast IS the brand voice.518- Use the eyebrow typography (`{typography.eyebrow}`, uppercase, 0.6px tracking) above every meaningful section.519- Use surface lift (canvas → surface-1 → surface-2) to express hierarchy on dark.520- Reserve product-chromatic cards for product identity; keep generic feature cards on `{colors.surface-1}`.521522### Don't523524- Don't ship a light-mode marketing page. HashiCorp's marketing brand IS dark.525- Don't introduce mid-tone gray text outside the documented `ink` / `ink-muted` / `ink-subtle` set.526- Don't square off CTA corners — use `{rounded.md}` 8px, not 0px.527- Don't use a product accent color for a CTA on a page that isn't about that product. Terraform purple on the Vault page is a brand violation.528- Don't combine multiple product accents in the same viewport — the system says "this section is about THIS tool", and mixing accents breaks that signal.529- Don't add drop shadows on dark; surface lift carries elevation.530- Don't replace `hashicorpSans` with a display-only sans for headlines and a different family for body. The brand is held together by one family across the full hierarchy.531532## Responsive Behavior533534### Breakpoints535536| Name | Width | Key Changes |537|---|---|---|538| Desktop-XL | 1440px | Default desktop layout |539| Desktop | 1280px | Pricing 3-up grid maintained |540| Tablet | 1024px | Product card grid 3-up → 2-up |541| Mobile-Lg | 768px | Pricing comparison becomes per-tier accordion; nav becomes hamburger |542| Mobile | 480px | Single-column everything; display-xl scales 80px → ~36px |543544### Touch Targets545546- CTA buttons (`button-primary`, `button-secondary`) maintain ≥40px tap height across viewports.547- Product pills are 24px tall on desktop and grow to 28px on touch viewports.548- Form inputs hold ≥44px tap target on touch viewports.549550### Collapsing Strategy551552- **Nav**: horizontal nav with right-anchored CTAs collapses to a hamburger overlay below 768px. The primary CTA stays visible on the bar.553- **Product card grid**: 3-up → 2-up at 1024px → 1-up below 768px.554- **Pricing comparison table**: collapses into per-tier accordions below 768px to avoid horizontal scroll.555- **Display type**: `{typography.display-xl}` 80px scales toward `{typography.display-md}` 40px on mobile while preserving the negative-tracking percentage.556557### Image Behavior558559- 3D product illustrations (cubes, safes, etc.) maintain aspect ratio and never crop; below 768px they shrink rather than reflow.560- Customer logo marquee scales horizontally and may wrap to a second row at narrow widths.561562## Iteration Guide5635641. Focus on ONE component at a time and reference it by its `components:` token name.5652. When introducing a new section, decide first whether it's a generic feature (surface-1) or a product-identity section (product-* color).5663. Default body to `{typography.body}` at 500 weight; reach for `{typography.subhead}` only inside CTA banners and feature cards.5674. Run `npx @google/design.md lint DESIGN.md` after edits.5685. Add new product variants as separate component entries (`product-card-nomad`, `button-product-consul`, etc.).5696. Treat the per-product palette as identity tokens, not decoration. If you reach for a product color outside its product context, the brand is drifting.5707. Eyebrow type is mandatory above every section — skipping it makes sections read as floating.571572## Known Gaps573574- The exact product-color hex values come from the `--mds-color-*` CSS variable set extracted directly; they are HashiCorp's canonical brand spec.575- Shadow tokens are not extensively documented because the dark surface system uses surface lift instead of shadow elevation.576- Form-field error and validation styling is not visible on the inspected pages.577- Dark mode is the only marketing mode — light-mode adaptation is not documented.578- Product-card variants for Consul, Nomad, Vagrant, and Boundary follow the documented Terraform / Vault / Waypoint pattern but are referenced in prose only; if they need formal entries they can be added as `product-card-consul`, `product-card-nomad`, etc.