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-10
…gray-75
), with legacygray-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.