CSScsstypographyresponsive-designcustom-propertiesproduction-ready

Fluid Typography Scale

Modern CSS clamp()-based fluid typography system with custom properties, modular scale, and responsive spacing that eliminates breakpoint jumps.

:root {
  /* ===== Configuration ===== */
  --fluid-min-width: 320;    /* Minimum viewport width (px) */
  --fluid-max-width: 1440;   /* Maximum viewport width (px) */

  /* Base font sizes */
  --fluid-min-size: 16;      /* Min base size (px) */
  --fluid-max-size: 20;      /* Max base size (px) */

  /* Modular scale ratio */
  --fluid-min-ratio: 1.2;    /* Minor third at mobile */
  --fluid-max-ratio: 1.333;  /* Perfect fourth at desktop */

  /* ===== Fluid Type Scale ===== */
  /* Each step uses clamp() for smooth interpolation between breakpoints */

  --font-size-sm: clamp(
    calc(var(--fluid-min-size) / var(--fluid-min-ratio) * 1px),
    calc(0.83vw + 0.67rem),
    calc(var(--fluid-max-size) / var(--fluid-max-ratio) * 1px)
  );

  --font-size-base: clamp(
    calc(var(--fluid-min-size) * 1px),
    calc(1vw + 0.75rem),
    calc(var(--fluid-max-size) * 1px)
  );

  --font-size-md: clamp(
    calc(var(--fluid-min-size) * var(--fluid-min-ratio) * 1px),
    calc(1.2vw + 0.9rem),
    calc(var(--fluid-max-size) * var(--fluid-max-ratio) * 1px)
  );

  --font-size-lg: clamp(
    calc(var(--fluid-min-size) * var(--fluid-min-ratio) * var(--fluid-min-ratio) * 1px),
    calc(1.5vw + 1.1rem),
    calc(var(--fluid-max-size) * var(--fluid-max-ratio) * var(--fluid-max-ratio) * 1px)
  );

  --font-size-xl: clamp(
    calc(var(--fluid-min-size) * var(--fluid-min-ratio) * var(--fluid-min-ratio) * var(--fluid-min-ratio) * 1px),
    calc(2vw + 1.3rem),
    calc(var(--fluid-max-size) * var(--fluid-max-ratio) * var(--fluid-max-ratio) * var(--fluid-max-ratio) * 1px)
  );

  --font-size-2xl: clamp(
    2rem,
    calc(3vw + 1.5rem),
    3.75rem
  );

  --font-size-3xl: clamp(
    2.5rem,
    calc(4vw + 1.75rem),
    5rem
  );

  /* ===== Fluid Spacing Scale ===== */
  --space-3xs: clamp(0.25rem, calc(0.25rem + 0.1vw), 0.375rem);
  --space-2xs: clamp(0.5rem, calc(0.45rem + 0.25vw), 0.75rem);
  --space-xs: clamp(0.75rem, calc(0.7rem + 0.35vw), 1rem);
  --space-sm: clamp(1rem, calc(0.9rem + 0.5vw), 1.5rem);
  --space-md: clamp(1.5rem, calc(1.35rem + 0.75vw), 2.25rem);
  --space-lg: clamp(2rem, calc(1.8rem + 1vw), 3rem);
  --space-xl: clamp(3rem, calc(2.7rem + 1.5vw), 4.5rem);
  --space-2xl: clamp(4rem, calc(3.6rem + 2vw), 6rem);

  /* ===== Line Heights ===== */
  --leading-tight: 1.2;
  --leading-snug: 1.35;
  --leading-normal: 1.5;
  --leading-relaxed: 1.65;

  /* ===== Font Stacks ===== */
  --font-sans: system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
  --font-serif: Georgia, Cambria, 'Times New Roman', Times, serif;
  --font-mono: 'JetBrains Mono', 'Fira Code', Consolas, 'Courier New', monospace;

  /* ===== Measure (Line Length) ===== */
  --measure-narrow: 45ch;
  --measure-normal: 65ch;
  --measure-wide: 80ch;
}

/* ===== Base Typography Styles ===== */
html {
  font-size: 100%;  /* Respects user preferences */
}

body {
  font-family: var(--font-sans);
  font-size: var(--font-size-base);
  line-height: var(--leading-normal);
  color: var(--color-text, #1a1a2e);
}

h1, h2, h3, h4, h5, h6 {
  line-height: var(--leading-tight);
  font-weight: 700;
  text-wrap: balance;
}

h1 { font-size: var(--font-size-3xl); margin-block: var(--space-xl) var(--space-md); }
h2 { font-size: var(--font-size-2xl); margin-block: var(--space-lg) var(--space-sm); }
h3 { font-size: var(--font-size-xl);  margin-block: var(--space-md) var(--space-xs); }
h4 { font-size: var(--font-size-lg);  margin-block: var(--space-sm) var(--space-xs); }
h5 { font-size: var(--font-size-md);  margin-block: var(--space-xs) var(--space-3xs); }
h6 { font-size: var(--font-size-base); margin-block: var(--space-xs) var(--space-3xs); }

p {
  max-inline-size: var(--measure-normal);
  margin-block-end: var(--space-sm);
}

small, .text-sm { font-size: var(--font-size-sm); }

/* ===== Utility Classes ===== */
.prose {
  --flow-space: var(--space-sm);
}

.prose > * + * {
  margin-block-start: var(--flow-space);
}

.prose :is(h2, h3, h4) {
  --flow-space: var(--space-lg);
}

.text-balance { text-wrap: balance; }
.text-pretty { text-wrap: pretty; }

title: "Fluid Typography Scale" description: "Modern CSS clamp()-based fluid typography system with custom properties, modular scale, and responsive spacing that eliminates breakpoint jumps." category: "CSS" language: "css" tags: ["css", "typography", "responsive-design", "custom-properties", "production-ready"] createdAt: "2024-11-22" updatedAt: "2025-01-05"

Overview

A complete fluid typography system that smoothly scales text and spacing between viewport sizes without media query breakpoints. Using CSS clamp() with custom properties creates a mathematically consistent type scale that respects user preferences and works across all screen sizes.

Key design decisions:

  • clamp() function provides min, preferred, and max values in a single declaration
  • Modular scale uses different ratios at mobile vs desktop for optical harmony
  • Custom properties make the system configurable and composable
  • Fluid spacing pairs with fluid type to maintain vertical rhythm at all sizes
  • ch-based measure limits line length for readability regardless of font size
  • text-wrap: balance prevents orphaned words in headings

Code

:root {
  /* Configuration */
  --fluid-min-width: 320;
  --fluid-max-width: 1440;
  --fluid-min-size: 16;
  --fluid-max-size: 20;
  --fluid-min-ratio: 1.2;    /* Minor third at mobile */
  --fluid-max-ratio: 1.333;  /* Perfect fourth at desktop */
 
  /* Fluid Type Scale */
  --font-size-sm: clamp(
    calc(var(--fluid-min-size) / var(--fluid-min-ratio) * 1px),
    calc(0.83vw + 0.67rem),
    calc(var(--fluid-max-size) / var(--fluid-max-ratio) * 1px)
  );
 
  --font-size-base: clamp(
    calc(var(--fluid-min-size) * 1px),
    calc(1vw + 0.75rem),
    calc(var(--fluid-max-size) * 1px)
  );
 
  --font-size-md: clamp(
    calc(var(--fluid-min-size) * var(--fluid-min-ratio) * 1px),
    calc(1.2vw + 0.9rem),
    calc(var(--fluid-max-size) * var(--fluid-max-ratio) * 1px)
  );
 
  --font-size-lg: clamp(
    calc(var(--fluid-min-size) * var(--fluid-min-ratio) * var(--fluid-min-ratio) * 1px),
    calc(1.5vw + 1.1rem),
    calc(var(--fluid-max-size) * var(--fluid-max-ratio) * var(--fluid-max-ratio) * 1px)
  );
 
  --font-size-xl: clamp(
    calc(var(--fluid-min-size) * var(--fluid-min-ratio) * var(--fluid-min-ratio) * var(--fluid-min-ratio) * 1px),
    calc(2vw + 1.3rem),
    calc(var(--fluid-max-size) * var(--fluid-max-ratio) * var(--fluid-max-ratio) * var(--fluid-max-ratio) * 1px)
  );
 
  --font-size-2xl: clamp(2rem, calc(3vw + 1.5rem), 3.75rem);
  --font-size-3xl: clamp(2.5rem, calc(4vw + 1.75rem), 5rem);
 
  /* Fluid Spacing */
  --space-3xs: clamp(0.25rem, calc(0.25rem + 0.1vw), 0.375rem);
  --space-2xs: clamp(0.5rem, calc(0.45rem + 0.25vw), 0.75rem);
  --space-xs: clamp(0.75rem, calc(0.7rem + 0.35vw), 1rem);
  --space-sm: clamp(1rem, calc(0.9rem + 0.5vw), 1.5rem);
  --space-md: clamp(1.5rem, calc(1.35rem + 0.75vw), 2.25rem);
  --space-lg: clamp(2rem, calc(1.8rem + 1vw), 3rem);
  --space-xl: clamp(3rem, calc(2.7rem + 1.5vw), 4.5rem);
  --space-2xl: clamp(4rem, calc(3.6rem + 2vw), 6rem);
 
  /* Line Heights */
  --leading-tight: 1.2;
  --leading-snug: 1.35;
  --leading-normal: 1.5;
  --leading-relaxed: 1.65;
 
  /* Measure */
  --measure-narrow: 45ch;
  --measure-normal: 65ch;
  --measure-wide: 80ch;
}
 
body {
  font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
  font-size: var(--font-size-base);
  line-height: var(--leading-normal);
}
 
h1 { font-size: var(--font-size-3xl); }
h2 { font-size: var(--font-size-2xl); }
h3 { font-size: var(--font-size-xl); }
h4 { font-size: var(--font-size-lg); }
 
p { max-inline-size: var(--measure-normal); }

Usage

/* Using the fluid scale in components */
.hero {
  padding-block: var(--space-2xl);
  padding-inline: var(--space-lg);
}
 
.hero-title {
  font-size: var(--font-size-3xl);
  line-height: var(--leading-tight);
  max-inline-size: var(--measure-narrow);
}
 
.card {
  padding: var(--space-md);
  gap: var(--space-sm);
}

Notes

  • Use Utopia to generate precise clamp() values for your specific min/max viewport and type scale
  • The calc(Xvw + Yrem) preferred value in clamp() creates a linear interpolation between min and max sizes
  • Setting html { font-size: 100% } respects the user's browser font size preference
  • text-wrap: balance is supported in Chrome 114+ and Safari 17.4+; use as progressive enhancement
  • Pair fluid type with a CSS reset that removes default margins to fully control vertical rhythm
  • For dark mode, consider slightly increasing font-weight or letter-spacing for legibility
  • Test with browser zoom (200%) to ensure text remains readable at all zoom levels