--- id: field-edge title: A field shows a line underneath, a full border only on request status: decided area: shape tokens: [border.field.line, border.field.invalid, border.field.contrast-more, color.border.subtle, color.status.error.text] applies-to: [prototype, components, design-site] check: manual source: designer decision 20 Nov 2026 (docs/f1/focus-shape.md row 3; colour row 6 for the grey) --- # A field shows a line underneath, a full border only on request A text field sits on white with one 1px line underneath in the subtle edge grey (3.49:1 on Papier). An invalid field gets a 2px edge in the error text colour, plus its icon and message. A full 2px border around the field appears only under `prefers-contrast: more`. ## Why The borderless look is the adopted paper feel; the line keeps the field identifiable at 3:1 (WCAG 2.2 SC 1.4.11) by default rather than only for users who ask. Measured on the darkest grain pixel, so the paper texture never takes the edge under 3:1. ## Do - Line colour from `color.border.subtle`; invalid from `color.status.error.text`. - Read-only: no line, tinted fill. Disabled: dashed line. ## Don't - Draw a box around every field by default. - Signal invalid by the edge alone (icon and message are part of the state).