Framework v2 Overview

Welcome to Framework v2. This overview highlights what’s new and what changed, and points you to detailed guides.

Highlights (new vs v1)

  • New responsive model (not present in v1): size breakpoints (sm, md, lg, xl), orientation prefixes (portrait:, landscape:), and bit‑depth variants (1bit:, 2bit:, 4bit:).
  • Automatic bit‑depth adaptation for Background, Border, and Text (single tokens render appropriately on 1‑, 2‑, and 4‑bit displays).
  • Expanded Background/Text palette to 16 shades (gray-10gray-75), with legacy gray-1..7 still supported (deprecated).
  • New utilities: Aspect Ratio, Scale, Visibility.
  • New elements/components: Progress (component), Divider (element).

What changed

  • New responsive model: v1 had no responsive prefixes. v2 adds size, orientation, and bit‑depth variants.
  • Border utility: only non‑backward compatible change. New 1–7 full‑spectrum scale that works on any surface shade. In v1, borders created faux grayscale only on white surfaces and appeared black/invisible on black surfaces.
  • Background/Text: expanded shade palette and bit‑depth responsiveness; legacy gray-1..7 tokens still render but are deprecated.

See Border, Background, and Text docs for details.

Start here

  • Upgrade Guide: concise steps to move from v1 to v2 (calls out the Border change).
  • Enhancement Guide: deep dive on new responsive capabilities and how to enhance your plugins.