Design

Screen sizes

Pages are made for the smallest screens first. Each screen size changes things from its width up, and you can see, edit and set every one of them in the editor.

A screen size is a width where a layout can change: Tablets start at 768px, Laptops at 1024px. Under the hood they're Elevate's breakpoints, written /md/ and /lg/ in a class list. Elevate is mobile first, so everything before the first marker is for every screen, and each marker changes things from its width up.

<section class="col gap:d4 /md/ row gap:d8">

This section is a column on phones and a row from tablets up.

See a page at any size

Press Screen sizes in the bar. The page opens at a phone's width, with a switch for each of the site's sizes. Wide sizes are scaled down to fit your window, and the note at the top says which layout that width uses. You can edit there as usual: click words, change pictures, use the blocks. Press Done and the page underneath catches up.

Style for a size

In Build a block, pick a size in the switch at the top. The preview narrows to where that size starts, and what you choose applies from there up. A dashed choice is one the element gets from a smaller size. A dot on a size means the selected element changes there.

Writing sizes by hand

Two rules cover it. Classes for every screen go before the first marker, and markers go smallest first. A class written after /lg/ applies from laptops up, even if it was meant for phones too:

<!-- The top border only shows from laptops up -->
<section class="pd:d5 /lg/ pd:d12 bd-t:width-px:solid:rule">

<!-- Every screen gets the border -->
<section class="bd-t:width-px:solid:rule pd:d5 /lg/ pd:d12">

Build a block always writes them in order. When a class list written by hand has its markers backwards, or the same marker twice, the editor says so under Worth a look at the top right, with the file and line. It's a note, so it doesn't stop Publish.

Change the sizes

The Screens tab in the Design panel lists the site's sizes, narrowest first, with how many places use each. Click one to rename it or move where it starts. Add one with a name and a width in pixels, like “Wide screens” at 1440: it shows up in Build a block straight away.

Removing a size that's in use asks first, then removes the styles set for it everywhere, so nothing is left pointing at a size that's gone. Moving a size never changes a class: every layout set for it just starts at the new width.

NameStarts atWritten
Small phones320px/2xs/
Large phones480px/xs/
Phones sideways640px/sm/
Tablets768px/md/
Laptops1024px/lg/
Desktops1280px/xl/
Large desktops1536px/2xl/
Full HD1920px/3xl/
QHD2560px/4xl/
4K screens3840px/5xl/

These are Elevate's defaults. A new size gets a short name from its words: “Wide screens” is written /wide-screens/.

Where they're kept

Widths go in elevate/design/tokens.json as "BreakPointToken", the whole set once you change one, which elevate/config/design.ts reads instead of Elevate's defaults:

BreakPointToken: tokens.BreakPointToken ?? breakpoints,

Sites made before this read Elevate's defaults directly; the first change in the Screens tab updates that line for you. The names people see are in verso.json as "screens", only where they differ from the defaults. Changing screen sizes needs Elevate 1.3 or later.