Atelier Theme¶
Atelier is an editorial, image-first storefront theme for premium, design-led catalogues: cool stone paper, deep ink, one glaze-green accent, a display serif set very large against a quiet grotesque. It is built on top of Nova (Atelier → Nova template fallback), exactly as Pop and Depot are, so every page works from the moment a site switches to it; Atelier replaces the pages where the look matters most.
Site admins pick it under Admin → Settings → Theme (Choosing a Theme); platform staff can also set it per site in System → Tenants → {site} → Theme (theme name Atelier).
Design principles¶
| Principle | What it means on the page |
|---|---|
| The picture leads | Cards and the product page are mostly photograph, with 2px corners and almost no chrome. A card whose product has a second picture swaps to it on hover or keyboard focus. |
| The name is the signature (opt-in) | With Product names over listing photos on (atelier-name-on-image, Settings > Collections, off by default), the feature cards of a category listing carry the product's name set enormous in the display serif, sitting on the bottom edge of the picture with only the feet of its letters running off. Its size follows the name's length, so a short name is huge and a longer one still shows its opening. It only appears where there is a picture to sit on, and only for names of 24 characters or fewer. It is off by default because over a real product photograph it covers the product and reads as a mistake; it suits simple, uncluttered product shots. The product page never repeats it: the name is in the buy box beside the pictures. |
| An asymmetric grid | Nine cards make a rhythm of mixed sizes (the 1st, 4th and 7th are the feature cards), set at different widths, offsets and drops. Every card has the same shape as the shop's product photos, so no card cuts the top and bottom off a product. It applies only in the merchant's own order: choosing a sort, applying a filter, or searching switches to an even three-column grid. |
| Small caps carry the labels | Navigation, filters, badges and buttons are small, tracked capitals. Headings and prices are serif. |
| Nothing is invented | Badges come from real flags (a saving, "Only 3 left", "Sold out"); there is no "new" badge because nothing on the model says a product is new. |
What Atelier redesigns¶
| Area | Highlights |
|---|---|
| Header / footer | A slim bar: category menu left, the site name as a serif wordmark in the middle, Search / Account / Basket (n) right. Search drops a sheet from the bar (as-you-type suggestions kept). The category menu opens a full-width panel of serif links; on phones, and on wider screens when the category row doesn't fit beside the name and the tools, it becomes a Menu button and drawer. The drawer starts with Home, since not every shopper knows the wordmark goes home, and its Search link opens the same search sheet. On phones Search stays in the bar as a magnifying-glass icon beside the basket, which shows as a bag with its count, so search is one tap from every page and the wordmark keeps the middle of the bar. Over a hero the bar is transparent and turns solid on scroll. Ink footer with the site name set enormous, standing on the bottom bar with only its descenders tucked under it. |
| Listings | Collection, search and merchandising pages: the collection name in large display type with its own description as a standfirst, sub-category chips (sibling categories, current one marked, on a category with none), and a bar that sticks under the header with the count, applied filters as chips and the sort. From 1024px the filters are a rail beside the grid, always open and scrolling on its own under the bar, and every tick applies at once (filtering is a reason to shop a big catalogue, so it is never behind a button): the groups the results chose, then More filters, with price buckets and min/max inputs, colour swatch dots, and number filters (a length) as range buckets plus min/max inputs with their unit, each pair of inputs with a two-thumb slider. Below 1024px the bar carries a quick-filter row: Filters (n) and a pill per top group, with In stock / On sale applying in one tap. Filters (n) or a group pill opens the filters as a full-screen sheet with a title and close button; taps there are staged, and a full-width Show N pieces button pinned to the foot of the sheet applies them all with a live count (closing discards them). On category pages and search the category nav is a row of chips with counts above the bar, and a category page has a Search in {category} box. The heading is kept compact, and once filters are applied its standfirst steps aside. After a filter, chip, sort or page change, the page opens scrolled to the filter bar (without the page transition), so the shopper stays with the results instead of starting again at the top. The search results page has its own search box, holding the query, so a shopper can search again without opening the header's search; an empty search page puts the cursor in it. When the searched term has a search rule with a banner, it shows under the heading, above the results (shared fragment/search-banner, styled by bdgr.css in the theme's accent). With Search box in the header on (storefront-search-box, Settings > Storefront, off by default), the header's Search becomes a field-like box with the search placeholder from 1440px wide; it opens the same search sheet, so as-you-type suggestions keep working. |
| Cards | Photograph, badges, the price, the name, and one quiet text action chosen by product type exactly as Nova's card does. |
| Product page | Margin notes, a gallery that shows every photo whole in the shop's photo shape (the first large, the rest two to a row on wide screens; a swipeable strip with a "1 / 4" count on phones), and a buy box that stays in view. Any photo opens a full-screen viewer on the shop's paper with zoom and pan, arrow keys and swipe (PhotoSwipe, loaded on the product page only), and on desktop the photo under the pointer is magnified. The page shows resized copies (fit-in); the viewer, and the magnifier once the pointer is over a photo, show the full size. The buy box: brand, name, rating, price, options (sizes as boxed tiles, colours as square swatches), stock, quantity and Add to basket, promises, and Description / Delivery accordions. A docked buy bar on phones. |
| Added to basket | A compact confirmation: a pop-over under the bar on desktop, the slide-over on phones. It shows the item, "Plus n other pieces in your basket", the subtotal, Checkout and View basket (n). "Plus n other pieces" opens the mini basket with the new line highlighted; View basket (n) goes to the basket page. |
| Mini basket | Clicking Basket (n) opens the whole basket as a slide-over from the right: serif names and totals, small-caps labels, every line with a quantity stepper and Remove, and the subtotal with Checkout and View full basket on the stone foot. Changes are made in place and the bar's count follows. Without JavaScript, and on the basket and checkout pages, the link goes to the basket page. |
| Rails | Trending, featured and recently-viewed use a staggered row of the same cards (swipeable on phones). |
Pages that fall back to Nova¶
Basket, checkout, order confirmation, account, blog and content extensions have no Atelier
template: they render Nova's markup inside Atelier's header and footer. They still look like
Atelier because Atelier re-points Nova's design tokens (palette, fonts, 2px radii) and restyles
Nova's buttons and inputs. Nova's standalone sign-in / register / password pages use Atelier's
copy of the shared auth-head fragment (ink buttons, serif headings).
The basket and checkout steps is the exception to "just tokens": Atelier sets a block of the basket's own
--nb-* tokens at the end of atelier.css, so it is a hairline-ruled list on the paper with a serif title and
total, small-caps labels, an ink checkout button and the order summary as a stone panel.
The transparent header¶
Whether the bar sits over a hero is decided by the page structure, not by the template: atelier.css
matches a hero (.nova-hero, or .at-hero) as the first thing in <main> with :has(), and only
then makes the bar transparent and pulls the hero under it. On every other page (and in a browser
without :has()) it is a plain solid sticky bar. A collection has no picture of its own on the
model, so collection pages do not have a hero unless a hero extension is placed in the topBanner
slot.
Over the hero the links turn white and the logo is drawn white too (a CSS filter, since the logo is an image and can't take the bar's colour: a dark logo used to vanish into a dark photo). Both carry a soft shadow, and a gradient darkens the top of the photo behind the bar, so they stay readable on a bright patch as well. The bar returns to the shop's own colours, and the logo to its own, once it turns solid.
What is not in Atelier (and why)¶
The design mock invented some data. These are deliberately absent, because the model has nothing to drive them and Atelier adds no back-end features:
- Collection hero picture and "The making" intro label – collections have no image or intro label; the name and description are set as the heading and standfirst instead.
- "Material notes" rows (body, glaze, firing, capacity, weight, foot) – no such attributes. The margin column shows only the brand, the product code and the short description, when they exist. (Specifications a site enters still show through the attribute extensions.)
- Glaze names on cards, "New" badge, "Care" accordion, photo captions – no data.
- Newsletter sign-up in the footer – needs a subscribe endpoint; a site can put its email-capture extension in the footer slot.
- Basket drawer with editable lines and a free-delivery progress bar – the slide-over shows the item just added and the subtotal only; lines live on the basket page, and there is no delivery threshold on the model.
- "In stock" filter toggle and material / colour / price groups as fixed filters – the drawer shows the real facet groups the search layer provides.
- Photo zoom and thumbnails on the product page – the gallery is a stack of pictures; a site's
own
productGalleryextension replaces it, as in every theme.
Configuring the copy¶
The "Shop all {0}" link at the foot of each admin-built menu dropdown (atelier.nav.shopAll) can
also be reworded or hidden per site with the nav-mega-menu-view-all-label and
nav-mega-menu-view-all-enabled site config keys; see
Brock: the "Shop all" link.
All Atelier wording is in messages.properties under atelier.* and can be overridden per site in
Admin → Settings → Site text (/admin/shopSettings/text). The ones a merchant should set:
| Key | Default | Where it shows |
|---|---|---|
nav.banner.message |
(empty) | A thin announcement line above the header. HTML allowed. Set it in Admin → Settings → Storefront → Announcement (storefront-announcement; switch the band off with Show Announcement Band); the Site Text key is the fallback when that is empty. |
atelier.promise.delivery |
(empty) | Footer, product page, "added" panel. e.g. "Free UK delivery over £60" |
atelier.promise.returns |
(empty) | As above. |
atelier.promise.secure |
(empty) | Footer, product page. |
atelier.promise.help |
(empty) | Footer reassurance row. |
atelier.pdp.deliveryInfo |
(empty) | "Delivery and returns" accordion on every product page (HTML allowed). |
atelier.pdp.priceNote |
(empty) | Line under the product price, e.g. "Including VAT". |
Nothing is shown for a key left empty, so a new site never shows a promise it has not written.
For developers¶
- Templates:
web-mvc/src/main/resources/templates/atelier/. Styles and behaviour:resources/settBuilder/themes/atelier/css/atelier.cssandjs/atelier.js, linked from Atelier'sfragment/head.htmlafter Nova'sbdgr.css(and before the Design Brief'stheme.css). - Atelier's
ThemeContextpointscssPath/jsPath/imagePathat Nova's folders, so Nova templates and extension scripts keep working; see Theme Resolution. Atelier's icons live infragment/atelier-icons.html(noticons.html) for the reason given there. - The signature. The listing card renders the name in an
aria-hiddenspan with--n(its length, minimum 4) as an inline custom property, only whenatelierNameOnImageis true (put on the model byCollectionControllerandMerchandisingPageControllerfromatelier-name-on-image), and leaves it out when the name is longer than 24 characters; the CSS sizes it asclamp(2.5rem, 100cqw / (--n * .42), 24cqw)inside a size container and sets itbottom: -0.06em(any lower and the frame cuts through the lowercase). The frames areoverflow: clip, nothidden: the span hangs below the frame, and ahiddenbox with overflow can be scrolled by find-in-page, focus orscrollIntoView, lifting the picture off its bottom edge. The card's span exists on every card with a picture and isdisplay: noneexcept on:nth-child(9n+1 | 9n+4 | 9n+7)of a grid that is not.is-flat. The template decides.is-flat(search, any filter, any sort other than the merchant's order); the rhythm itself is CSS-only, so no per-card data is needed. The product page has no overprint. - One card shape. Every listing card's frame is
aspect-ratio: var(--product-image-ratio): 4:5 by default (set on Atelier's:root), or the shape chosen as the product photo shape in the Design Brief (portrait 3:4, tall 2:3, landscape 4:3; "square" writes nothing, so Atelier stays 4:5). The rhythm varies only the card's columns, offsets and drops. It used to give some positions their own shape (5:6, 1:1, 4:3), and withobject-fit: coverthat cut a portrait packshot (a coat, a dress) to a band across its middle on every fourth or fifth card (the rails' cards too, which the same selectors reached). On desktop the feature cards span six of the twelve columns, since a seven-column 4:5 card is taller than the screen. Between 600px and 899px they take three quarters of the row (the 1st on the left, the 7th on the right). Below 900px the right-hand card of each pair drops 48px, so the two columns don't line up row by row. - Colour photos. The variant picker (Nova's
variants.js) shows a chosen colour's own images throughwindow.BadgerGallery.updateImages, which Nova'sproduct-gallery.jsprovides for the other themes;atelier.jsprovides it for Atelier's stack of figures (rebuilt with the same classes, badges kept). A productGallery extension brings its own. - Colour swatches.
atelier.jsturns a colour option group (its code or label matchescolour|color|glaze|shade) into square swatches when every value is a colour name the browser understands (CSS.supports('color', …)); one unknown name leaves the group as text. The button keeps its text as its accessible name. - Filters. Filters are plain links.
fragment/atelier-listing.htmlputs the filters (#at-filters) and the shelf side by side in.at-listing.has-rail; from 1024px CSS makes them a sticky rail and every tap applies. Below 1024px the sharednova/js/modules/facet-sheet.jsstages taps (data-facet-sheet-media="(max-width: 1023px)") and the quick-filter row opens the panel as a fixed, full-screen sheet (.is-open, set byatelier.json facet-sheet'sfacet:open/facet:close), with.at-filters__head(title,data-facet-dismissclose) and the apply button in.at-filters__foot. Without JS every tap applies and the filters are always open (.at-jsgates the hidden state; the class is set by a one-line inline script inhead.htmlso there is no flash). - Long category menus. An inline script after the header (
fragment/nav.html) compares the row's width with its side of the bar (the brand stays centred, so each side gets half of what is left) and sets.at-nav-compacton<html>when it doesn't fit, which swaps the row for the Menu button and drawer. It runs before first paint and again on resize, font and image load, and when a cached menu is restored. Without JS the row scrolls sideways inside its column, so the page never gets wider than the screen. - Fonts (Instrument Serif, static regular and italic; Hanken Grotesk, variable) are self-hosted from
@fontsourcepackages: the Latin and Latin-ext subsets are vendored (seescripts/copy-versioned-deps.js) and declared inline infragment/head.html(and in the auth pages' head). No request goes to a third-party font host. - Atelier reuses Nova's scripts (variant picker, sticky buy bar, search suggestions, basket repricing) unchanged; each template documents the ids and classes it keeps for them.
- Tests:
AtelierProductCardRenderTestrenders both cards for every image state and checks the oversized-name sizing (and its absence for a long name), that the hover image only exists with a second picture, and that badges appear only for real flags. - The theme record is added by system update
89.json(idempotent) andinitialisation/templates.json.