Vale (Theme documentation)

(Guides · Accessibility)

Accessibility and motion

Vale moves slowly and on purpose, and it stays still when a visitor asks it to. Every interaction works with a keyboard, and every page reads properly without JavaScript.

Motion settings

In Theme settings > Animations:

Reveal sections on scroll
Headlines rise line by line, images open from a clip
Scroll effects
Off · Subtle (default) · Expressive. Movement tied to scrolling across the whole theme; see below
Page transitions
A curtain carrying the destination's name rises between pages. Off in the theme editor
Curtain color scheme
Also used by the preloader
Preloader
Off by default. The wordmark lights up once per visit, for at most two seconds
Hover effects
None · Subtle · Full. Image zoom and second image on cards, only on devices with a pointer

In Theme settings > Layout, Film grain adds a subtle moving texture (strength 7 by default). It is decorative, stands still for visitors who prefer reduced motion, and can be turned off.

Each scroll section has its own Animate on scroll and Intensity settings. See Scroll sections. Background videos play only while on screen and never for visitors who prefer reduced motion, who see the poster image instead.

Scroll effects

Theme settings > Animations > Scroll effects adds gentle movement that follows the scroll, across the sections you already have. It is separate from the scroll sections, which keep their own switches, and from Reveal sections on scroll, which plays once as a section appears.

Off
No scroll-tied movement. The theme's extra stylesheet and script for it are not loaded
Subtle
The default in both presets. Small movements that settle quickly
Expressive
The same effects, travelling about twice as far, plus a slight lean on some text rows while you scroll fast (at most 1.6°)

What moves, at Subtle and Expressive:

  • Photographs drift inside their frames. The image moves a little slower than its frame and is scaled just enough that no edge shows: in the editorial cover, editorial letter, image with text, rooms grid, showroom, statement with image, story opening, lookbook, founder quote and product spotlight.
  • The editorial cover gains depth as it scrolls away: on desktop the text rises and fades while the plate lags behind, and the giant wordmark sinks at every width.
  • Headlines settle. Each line of the heading arrives from a small sideways offset, the lower lines from further (collection tabs, editorial letter, product spotlight, lookbook, rooms grid, showroom). In the closing statement the lines arrive from alternate sides.
  • Images open with the scroll. The lead lookbook image and the founder quote portrait open from a slight inset as they cross the screen.
  • Cards drift in. Featured collection cards slide in sideways, the far ones further, and the collection tabs grid starts with alternate tiles lower, then settles level.
  • The footer curtain. The giant footer wordmark grows and rises into place as the footer arrives.
  • The ground shifts. Where a light section is followed by a dark one (or the other way round), the leaving section takes on part of the coming colour, so the change feels like light fading. Pinned stories (route stack, chapter counter) keep their own ending.
  • Velocity lean (Expressive only). The moving text lines and the statement with image lean very slightly with scroll speed, then straighten.

Everything starts and ends at the normal layout, so nothing shifts while the page loads, and the first hero image is never clipped or faded. Browsers that support CSS scroll timelines run the effects without any script on scroll; others use a small fallback that only runs while a section is on screen.

(Still layout)

With Off, for visitors who prefer reduced motion, inside the theme editor and with JavaScript turned off, every section shows its plain, still layout. So you always edit exactly what a still visitor sees.

Reduced motion

When a visitor has turned on reduced motion in their system settings, Vale shows every section in its final, still state: no reveals, no page curtain, no drifting images, no auto-rotating slides, no scroll effects, no background video and no moving grain. The same applies inside the theme editor, so you always edit what you see.

Keyboard and screen readers

  • A skip link, landmarks and one H1 per page.
  • Menus, the mega menu, drawers and pop-ups announce their state, trap focus while open, close with Escape and return focus to the button that opened them.
  • Carousels and rotating announcements have pause controls and pause on hover and focus.
  • Forms have labels, inline errors and an error summary.
  • Primary controls are at least 44px, and every control at least 24px.

Color contrast

The default schemes meet WCAG AA contrast for text. When you change colors, keep body text at 4.5:1 against its background, and check the muted color too, since it is used for labels.

(Watch out)

Scheme 5 (Accent) is designed for callouts and badges. Used as the header scheme, its navigation links fall below 4.5:1. Keep the header on Scheme 1, 3 or 4.

Your content

  • Add alt text to images in the admin; Vale uses it everywhere, including the mega menu and lookbook.
  • Set a Video description on video sections.
  • Use the page.accessibility template for an accessibility statement.