KovieraDocs

Documentation v1.0.0

Koviera

Multi-Purpose Ecommerce HTML Template. Everything you need to edit the pages, re-theme them, and put them online.

  • 10 storefronts
  • 80 pages
  • 45 components
  • 33 sections
  • 273 design tokens

Introduction

Koviera is a multi-purpose ecommerce HTML template. Ten storefronts — fashion, furniture, electronics, perfume & beauty, shoes, bags, watches, organic groceries, jewellery and toys — share one design system: the same components, the same product card, one stylesheet.

The preview landing page
html/index.html — the landing that links to every storefront and page

Everything in html/ is finished, indented, hand-editable HTML. Open a page, change the words and the images, and upload the folder. There is no build step and nothing to install.

What is in the download

Folder or fileWhat it holds
html/The 80 finished pages, plus css, js, images and fonts
documentation/This manual
licenses/Licence text for Bootstrap, Popper, Swiper, GLightbox and Uiverse
tools/The optional minifier behind npm run build
SETUP.txtThe first five minutes: run it, colours, logo, images, forms
CREDITS.mdEvery third-party asset and its licence
CHANGELOG.mdWhat changed in each version

Three pages worth opening first

  • html/elements.html — every component and variant, ready to copy
  • html/sections.html — every section and configuration, rendered live
  • html/tokens.html — every design token with a live sample

Browser support

The latest two versions of Chrome, Edge, Firefox and Safari; Safari and iOS Safari 16.4 and newer; Chrome for Android. The stylesheets use color-mix(), :has() and container queries, which older browsers do not understand.

Getting started

Previewing the pages

Every page is standalone and every path is relative, so html/ works from any location. Double-click a page and it opens straight from disk, with the cart, the sliders and every drawer working — no server, no network.

If you prefer a local server while you work, any static server will do:

Terminal
npx serve html
python -m http.server 8080 --directory html

To publish, upload the contents of html/ to your host.

Editing a page

Open the page in your editor and change it. Copy a component from html/elements.html or a whole section from html/sections.html and paste it where you want it. Each page links only the stylesheets and scripts it uses, so if the page does not link the component's files yet, copy them too: its <link> from elements.html or sections.html into the page's <!-- koviera:css --> block, keeping the order of html/css/main.css, and its <script> into the page's <!-- koviera:js --> block — see "JavaScript", "Adding a component to a page".

Where things live

I want to changeEdit
Colours, type, spacinghtml/css/tokens/ — see "Design tokens"
A storefront's palettehtml/css/themes/<name>.css, named by data-vt-theme on <html>
A component's lookhtml/css/components/<name>.css
A component's behaviourhtml/js/components/<name>.js
The logo.vt-logo in the header and footer of each page
Products, prices, wordsThe page itself — everything is in the HTML
Imageshtml/assets/images/, then the <img> tags
Currencywindow.VT_CONFIG — see "JavaScript"

Folder structure

Text
html/                     the template — upload this folder
  index.html              preview landing: every demo and page
  home-*.html             ten storefront homepages
  shop*.html              five shop layouts, plus one shop per storefront
  product-*.html          three product layouts, plus one per storefront
  cart*.html, checkout*.html, order-*.html
  account*.html, login.html, register.html, forgot-password.html
  blog*.html, about.html, contact.html, faq.html, ... the content pages
  elements.html           every component and variant
  sections.html           every section and configuration
  tokens.html             every design token
  robots.txt              edit before you go live
  css/
    main.css              the order of every stylesheet below
    tokens/               design tokens: colours, type, spacing, radius...
    base/                 reset, fonts, typography, links, forms, buttons
    vendor/               class hooks for Swiper
    layout/               grid, section
    components/           one file per component
    sections/             one file per section family
    pages/                page-specific layout
    modes/                type, shape and rhythm; every page uses editorial,
                          the others are ready to swap in
    themes/               one file per colour palette
    utilities/            vt-u-* helpers
    libs/                 GLightbox's stylesheet
  js/
    core/                 app start-up, component registry, DOM helpers
    adapters/             the data source: cart, wishlist, compare
    components/           one file per interactive component
    ecommerce/            cart page, checkout, filters, saved lists
    libs/                 Bootstrap (with Popper), Swiper, GLightbox
  dist/                   minified copies — see "Minified build"
  assets/
    css/                  Bootstrap, left-to-right and right-to-left
    fonts/                Inter and Fraunces, with their licences
    images/               placeholder, brand marks, demo thumbnails
    favicon.svg
documentation/            this manual
licenses/                 licence text of every bundled library
tools/                    the minifier behind npm run build
package.json              only for npm run build

What a page loads

Each page links only the stylesheets whose rules can apply to it — its own palette, its own sections, the components it uses — between <!-- koviera:css --> and <!-- /koviera:css -->. A shop or content page loads under sixty of the 145, a storefront homepage around seventy; sections.html, which shows everything, loads the most. To use a component or section on a page that does not have it yet, add its stylesheet to that page's block, in the order css/main.css gives.

Scripts work the same way. Every page loads the core — the component registry, the cart, wishlist and compare, the header's helpers — plus the file of each component it uses, in dependency order, between <!-- koviera:js --> and <!-- /koviera:js -->. Swiper and GLightbox load only on the pages that use them.

The rule that keeps it navigable

A component owns its markup, its styles and its behaviour, and they are named the same in all three places:

Text
class="vt-product-card"        the markup, in the pages
css/components/product-card.css
js/components/carousel.js      data-vt-component="carousel"

Class names follow one pattern: vt- namespace, then BEM — .vt-product-card__title, .vt-product-card--overlay. Utilities are .vt-u-*.

Design tokens

273 tokens, declared in html/css/tokens/ — one file per group, the same groups as below. html/tokens.html shows each one with a live sample.

The design tokens page
tokens.html — every token with a live sample

Tokens come in two layers. Primitive tokens are raw values. Semantic tokens are what components reference. Change a semantic token and every component follows; change a primitive and you change the palette everywhere it is used.

To re-theme, override semantic tokens only, in a theme file of your own (html/css/themes/mine.css, linked from the page) named on the page's <html data-vt-theme="mine">:

CSS
[data-vt-theme="mine"] {
  --vt-c-primary: #1c1a17;
  --vt-c-bg: #faf7f0;
  --vt-font-heading: var(--vt-font-serif);
}

Any token that carries text must reach 4.5:1 contrast against both --vt-c-bg and --vt-c-bg-soft. Every palette that ships meets it.

colors

TokenValueLayer
--vt-color-neutral-0#fffprimitive
--vt-color-neutral-25#fbfbfbprimitive
--vt-color-neutral-50#f6f6f6primitive
--vt-color-neutral-100#edededprimitive
--vt-color-neutral-200#e0e0e0primitive
--vt-color-neutral-300#c9c9c9primitive
--vt-color-neutral-400#a3a3a3primitive
--vt-color-neutral-500#6b6b6bprimitive
--vt-color-neutral-600#565656primitive
--vt-color-neutral-700#3d3d3dprimitive
--vt-color-neutral-800#262626primitive
--vt-color-neutral-900#141414primitive
--vt-color-neutral-950#0a0a0aprimitive
--vt-color-brand-500#141414primitive
--vt-color-brand-600#000primitive
--vt-color-red-500#b8302cprimitive
--vt-color-red-600#9c2723primitive
--vt-color-green-500#23824eprimitive
--vt-color-amber-500#c07f14primitive
--vt-color-blue-500#1a6be8primitive
--vt-color-orange-100#fff1e3primitive
--vt-color-orange-300#f9c893primitive
--vt-color-orange-500#e2681bprimitive
--vt-color-orange-600#c4560fprimitive
--vt-color-orange-700#a8480cprimitive
--vt-c-primaryvar(--vt-color-brand-500)semantic
--vt-c-primary-hovervar(--vt-color-brand-600)semantic
--vt-c-on-primaryvar(--vt-color-neutral-0)semantic
--vt-c-secondaryvar(--vt-color-neutral-600)semantic
--vt-c-accentvar(--vt-color-brand-600)semantic
--vt-c-on-accentvar(--vt-color-neutral-0)semantic
--vt-c-accent-hovercolor-mix( in srgb, var(--vt-c-accent-ink) 86%, var(--vt-c-heading) )semantic
--vt-c-accent-inkcolor-mix(in srgb, var(--vt-c-accent) 55%, var(--vt-c-heading))semantic
--vt-c-textvar(--vt-color-neutral-700)semantic
--vt-c-headingvar(--vt-color-neutral-900)semantic
--vt-c-mutedvar(--vt-color-neutral-500)semantic
--vt-c-text-inversevar(--vt-color-neutral-300)semantic
--vt-c-heading-inversevar(--vt-color-neutral-0)semantic
--vt-c-bordervar(--vt-color-neutral-200)semantic
--vt-c-border-strongvar(--vt-color-neutral-400)semantic
--vt-c-border-inversergb(255 255 255 / 0.16)semantic
--vt-c-heading-pagevar(--vt-c-heading)semantic
--vt-c-text-pagevar(--vt-c-text)semantic
--vt-c-muted-pagevar(--vt-c-muted)semantic
--vt-c-secondary-pagevar(--vt-c-secondary)semantic
--vt-c-border-pagevar(--vt-c-border)semantic
--vt-c-border-strong-pagevar(--vt-c-border-strong)semantic
--vt-c-link-hover-pagevar(--vt-c-link-hover)semantic
--vt-c-link-underline-pagevar(--vt-c-link-underline)semantic
--vt-c-nav-hover-pagevar(--vt-c-nav-hover)semantic
--vt-c-bg-pagevar(--vt-c-bg)semantic
--vt-c-bg-soft-pagevar(--vt-c-bg-soft)semantic
--vt-c-bg-muted-pagevar(--vt-c-bg-muted)semantic
--vt-c-price-pagevar(--vt-c-price)semantic
--vt-c-price-old-pagevar(--vt-c-price-old)semantic
--vt-c-sale-pagevar(--vt-c-sale)semantic
--vt-c-primary-pagevar(--vt-c-primary)semantic
--vt-c-accent-ink-pagevar(--vt-c-accent-ink)semantic
--vt-brand-logo-filter-pagevar(--vt-brand-logo-filter)role
--vt-c-bgvar(--vt-color-neutral-0)semantic
--vt-c-bg-softvar(--vt-color-neutral-50)semantic
--vt-c-bg-mutedvar(--vt-color-neutral-100)semantic
--vt-c-bg-inversevar(--vt-color-neutral-950)semantic
--vt-c-overlayrgb(10 10 10 / 0.5)semantic
--vt-c-primary-fillnonesemantic
--vt-c-primary-fill-deepnonesemantic
--vt-c-glowtransparentsemantic
--vt-c-washnonesemantic
--vt-c-wash-inversenonesemantic
--vt-c-nav-hovervar(--vt-c-heading)semantic
--vt-c-linkcurrentcolorsemantic
--vt-c-link-hovervar(--vt-color-neutral-900)semantic
--vt-c-link-underlinevar(--vt-color-neutral-300)semantic
--vt-c-successvar(--vt-color-green-500)semantic
--vt-c-success-inkcolor-mix(in srgb, var(--vt-c-success) 72%, var(--vt-c-heading))semantic
--vt-c-success-surfacevar(--vt-c-success)semantic
--vt-c-warningvar(--vt-color-amber-500)semantic
--vt-c-dangervar(--vt-color-red-500)semantic
--vt-c-infovar(--vt-color-blue-500)semantic
--vt-c-salevar(--vt-color-red-500)semantic
--vt-c-sale-basevar(--vt-c-sale)semantic
--vt-c-sale-surfacevar(--vt-c-sale)semantic
--vt-c-pricevar(--vt-color-neutral-900)semantic
--vt-c-price-oldvar(--vt-color-neutral-500)semantic
--vt-c-ratingvar(--vt-color-amber-500)semantic
--vt-c-focusvar(--vt-color-orange-500)semantic
--vt-c-field-accentvar(--vt-color-orange-500)semantic
--vt-c-sale-band#6d1618semantic
--vt-c-field-tintcolor-mix(in srgb, var(--vt-c-field-accent) 12%, var(--vt-c-bg))semantic
--vt-brand-logo-filterbrightness(0.4)role
--vt-brand-logo-filter-inversebrightness(2.6)role
--vt-c-checkvar(--vt-c-primary)semantic
--vt-gradient-checklinear-gradient(135deg, #7a3408 0%, #c4560f 46%, #e2681b 100%)role
--vt-c-check-surfacelinear-gradient(var(--vt-c-check), var(--vt-c-check))semantic
--vt-c-check-surface-deepvar(--vt-gradient-check-deep)semantic
--vt-gradient-check-deeplinear-gradient( 135deg, #5c2606 0%, #8a3a09 46%, var(--vt-color-orange-700) 100% )role
--vt-radio-dotradial-gradient( circle closest-side, color-mix(in srgb, var(--vt-c-check) 78%, #fff) 0%, var(--vt-c-check) 50%, var(--vt-c-check) 56%, color-mix(in srgb, var(--vt-c-check) 22%, transparent) 72%, transparent 100% )role
--vt-scrim-blocklinear-gradient( to top, rgb(0 0 0 / 0.88) 0%, rgb(0 0 0 / 0.68) 38%, rgb(0 0 0 / 0.1) 100% )role
--vt-scrim-block-fulllinear-gradient( to top, rgb(0 0 0 / 0.72) 0%, rgb(0 0 0 / 0.6) 100% )role
--vt-scrim-block-edgelinear-gradient( var(--vt-scrim-angle, calc(90deg * var(--vt-scrim-dir, 1))), rgb(0 0 0 / 0.7) 0%, rgb(0 0 0 / 0.7) calc(100% - var(--vt-scrim-fade, 3rem)), rgb(0 0 0 / 0.42) calc(100% - var(--vt-scrim-fade, 3rem) / 2), rgb(0 0 0 / 0) 100% )role
--vt-scrim-block-downlinear-gradient( to bottom, rgb(0 0 0 / 0.72) 0%, rgb(0 0 0 / 0.62) 45%, rgb(0 0 0 / 0.05) 100% )role
--vt-scrim-inlinelinear-gradient( to right, rgb(0 0 0 / 0.72) 0%, rgb(0 0 0 / 0.6) 45%, rgb(0 0 0 / 0.12) 100% )role

typography

TokenValueLayer
--vt-font-sans"Inter", "Inter Fallback", system-ui, -apple-system, "Segoe UI", roboto, helvetica, arial, sans-serifrole
--vt-font-serif"Fraunces", "Fraunces Fallback", georgia, "Times New Roman", times, serifrole
--vt-font-monoui-monospace, sfmono-regular, menlo, consolas, monospacerole
--vt-font-bodyvar(--vt-font-sans)role
--vt-font-headingvar(--vt-font-sans)role
--vt-font-displayvar(--vt-font-heading)role
--vt-font-navvar(--vt-font-body)role
--vt-font-buttonvar(--vt-font-body)role
--vt-font-pricevar(--vt-font-body)role
--vt-text-2xs0.75remrole
--vt-text-xs0.8125remrole
--vt-text-sm0.875remrole
--vt-text-base1remrole
--vt-text-md1.0625remrole
--vt-text-lgclamp(1.0625rem, 1.02rem + 0.2vw, 1.125rem)role
--vt-text-xlclamp(1.1875rem, 1.1rem + 0.4vw, 1.375rem)role
--vt-text-2xlclamp(1.375rem, 1.24rem + 0.68vw, 1.75rem)role
--vt-text-3xlclamp(1.625rem, 1.4rem + 1.12vw, 2.25rem)role
--vt-text-4xlclamp(2rem, 1.6rem + 2vw, 3rem)role
--vt-text-5xlclamp(2.5rem, 1.8rem + 3.5vw, 4.5rem)role
--vt-text-6xlclamp(3rem, 1.9rem + 5.5vw, 6rem)role
--vt-leading-none1role
--vt-leading-tight1.15role
--vt-leading-snug1.3role
--vt-leading-normal1.6role
--vt-leading-relaxed1.75role
--vt-weight-light300role
--vt-weight-regular400role
--vt-weight-medium500role
--vt-weight-semibold600role
--vt-weight-bold700role
--vt-weight-extrabold800role
--vt-weight-black900role
--vt-tracking-tighter-0.02emrole
--vt-tracking-tight-0.01emrole
--vt-tracking-normal0role
--vt-tracking-wide0.05emrole
--vt-tracking-wider0.12emrole
--vt-heading-weightvar(--vt-weight-medium)role
--vt-heading-trackingvar(--vt-tracking-tight)role
--vt-heading-transformnonerole
--vt-nav-sizevar(--vt-text-base)role
--vt-nav-weightvar(--vt-weight-medium)role
--vt-nav-trackingvar(--vt-tracking-normal)role
--vt-nav-transformnonerole
--vt-button-sizevar(--vt-text-sm)role
--vt-button-weightvar(--vt-weight-medium)role
--vt-button-trackingvar(--vt-tracking-wide)role
--vt-button-transformuppercaserole
--vt-product-title-sizevar(--vt-text-base)role
--vt-product-title-weightvar(--vt-weight-regular)role
--vt-price-sizevar(--vt-text-base)role
--vt-price-weightvar(--vt-weight-medium)role
--vt-caption-sizevar(--vt-text-xs)role
--vt-eyebrow-sizevar(--vt-text-2xs)role
--vt-eyebrow-trackingvar(--vt-tracking-wider)role
--vt-eyebrow-weightvar(--vt-weight-regular)role
--vt-display-familyvar(--vt-font-display)role
--vt-display-sizevar(--vt-text-5xl)role
--vt-display-weightvar(--vt-weight-medium)role
--vt-display-trackingvar(--vt-tracking-tighter)role
--vt-display-leadingvar(--vt-leading-tight)role
--vt-editorial-familyvar(--vt-font-serif)role
--vt-editorial-sizevar(--vt-text-2xl)role
--vt-editorial-weightvar(--vt-weight-regular)role
--vt-editorial-trackingvar(--vt-tracking-normal)role
--vt-editorial-leadingvar(--vt-leading-snug)role
--vt-heading-familyvar(--vt-font-heading)role
--vt-heading-leadingvar(--vt-leading-tight)role
--vt-body-familyvar(--vt-font-body)role
--vt-body-sizevar(--vt-text-base)role
--vt-body-weightvar(--vt-weight-regular)role
--vt-body-leadingvar(--vt-leading-normal)role
--vt-label-sizevar(--vt-text-2xs)role
--vt-label-weightvar(--vt-weight-medium)role
--vt-label-trackingvar(--vt-tracking-wide)role
--vt-label-transformuppercaserole
--vt-price-sale-sizevar(--vt-price-size)role
--vt-price-sale-weightvar(--vt-weight-semibold)role
--vt-product-meta-sizevar(--vt-text-xs)role
--vt-product-meta-weightvar(--vt-weight-regular)role
--vt-product-meta-trackingvar(--vt-tracking-normal)role
--vt-badge-sizevar(--vt-text-2xs)role
--vt-badge-weightvar(--vt-weight-medium)role
--vt-badge-trackingvar(--vt-tracking-wide)role
--vt-form-sizevar(--vt-text-base)role
--vt-form-weightvar(--vt-weight-regular)role
--vt-form-trackingvar(--vt-tracking-normal)role

spacing

TokenValueLayer
--vt-space-00role
--vt-space-10.25remrole
--vt-space-20.5remrole
--vt-space-30.75remrole
--vt-space-41remrole
--vt-space-51.5remrole
--vt-space-62remrole
--vt-space-73remrole
--vt-space-84remrole
--vt-space-95remrole
--vt-space-106remrole
--vt-space-117.5remrole
--vt-guttervar(--vt-space-4)role
--vt-grid-gapvar(--vt-space-5)role
--vt-section-pyvar(--vt-space-6)role
--vt-section-head-gapvar(--vt-space-6)role
--vt-control-py0.75remrole
--vt-control-pxvar(--vt-space-4)role

breakpoints

TokenValueLayer
--vt-bp-sm576pxrole
--vt-bp-md768pxrole
--vt-bp-lg1024pxrole
--vt-bp-xl1280pxrole
--vt-bp-xxl1536pxrole
--vt-container-narrow45remrole
--vt-container-md60remrole
--vt-container-max92.5remrole
--vt-container-wide100remrole

radius

TokenValueLayer
--vt-radius-none0role
--vt-radius-xs0.125remrole
--vt-radius-sm0.25remrole
--vt-radius-md0.375remrole
--vt-radius-lg0.625remrole
--vt-radius-xl1remrole
--vt-radius-pill62.4375remrole
--vt-radius-circle50%role
--vt-radius-controlvar(--vt-radius-sm)role
--vt-radius-cardvar(--vt-radius-md)role
--vt-radius-mediavar(--vt-radius-sm)role
--vt-radius-badgevar(--vt-radius-sm)role

shadows

TokenValueLayer
--vt-shadow-nonenonerole
--vt-shadow-xs0 1px 2px rgb(0 0 0 / 0.05)role
--vt-shadow-sm0 2px 6px rgb(0 0 0 / 0.06)role
--vt-shadow-md0 6px 20px rgb(0 0 0 / 0.08)role
--vt-shadow-lg0 14px 44px rgb(0 0 0 / 0.12)role
--vt-shadow-xl0 28px 80px rgb(0 0 0 / 0.16)role
--vt-shadow-focus0 0 0 3px rgb(226 104 27 / 0.35)role
--vt-shadow-cardvar(--vt-shadow-none)role
--vt-shadow-card-hovervar(--vt-shadow-md)role
--vt-shadow-overlayvar(--vt-shadow-lg)role

z-index

TokenValueLayer
--vt-z-below-1role
--vt-z-base1role
--vt-z-raised10role
--vt-z-sticky100role
--vt-z-header200role
--vt-z-dropdown300role
--vt-z-overlay400role
--vt-z-offcanvas500role
--vt-z-modal600role
--vt-z-toast700role
--vt-z-tooltip800role

ratios

TokenValueLayer
--vt-ratio-product3 / 4role
--vt-ratio-card1 / 1role
--vt-ratio-product-tall2 / 3role
--vt-ratio-square1 / 1role
--vt-ratio-landscape4 / 3role
--vt-ratio-photo3 / 2role
--vt-ratio-wide16 / 9role
--vt-ratio-banner21 / 9role
--vt-ratio-category4 / 5role

motion

TokenValueLayer
--vt-duration-instant80msrole
--vt-duration-fast150msrole
--vt-duration-base250msrole
--vt-duration-slow400msrole
--vt-duration-slower700msrole
--vt-ease-linearlinearrole
--vt-ease-outcubic-bezier(0.22, 1, 0.36, 1)role
--vt-ease-incubic-bezier(0.55, 0, 1, 0.45)role
--vt-ease-in-outcubic-bezier(0.65, 0, 0.35, 1)role
--vt-ease-springcubic-bezier(0.34, 1.56, 0.64, 1)role
--vt-transition-colorcolor var(--vt-duration-fast) var(--vt-ease-out), background-color var(--vt-duration-fast) var(--vt-ease-out), border-color var(--vt-duration-fast) var(--vt-ease-out)role
--vt-transition-transformtransform var(--vt-duration-base) var(--vt-ease-out)role

assets

TokenValueLayer
--vt-star-maskurl("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 21 20'%3E%3Cpath d='M10.5 1.2l2.8 5.7 6.2.9-4.5 4.4 1.1 6.2-5.6-2.9-5.6 2.9 1.1-6.2L1.5 7.8l6.2-.9z'/%3E%3C/svg%3E")role
--vt-check-maskurl("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3E%3Cpath d='M4 10.5l4 4 8-9' fill='none' stroke='%23000' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E")role

Components

45 components. Each one's styles are in its own file, html/css/components/<name>.css, and its behaviour, where it has any, in html/js/components/<name>.js.

The product card
The product card — one component for every grid, rail and carousel
Card variants
The same card in the storefronts' variants
Tabs
Tabs, in the styles the storefronts use
ComponentWhat it is
accordionBootstrap 5 accordion. Declarative: data-bs-toggle="collapse" plus data-bs-parent for one-at-a-time. No Koviera JavaScript behind it.
badgeSale flags, stock states and counters. Label is always a text node.
breadcrumbTrail plus BreadcrumbList JSON-LD. The current page is not a link.
buttonBootstrap 5 button. Emits btn btn-*; the bridge re-points Bootstrap's --bs-btn-* variables at the theme tokens, and adds the two variants Bootstrap lacks (btn-ghost, btn-icon).
carouselSwiper wrapper loaded on demand. Reads direction from the document for RTL.
cart-drawerCart contents on the shared overlay engine, rendered from the data source.
checkboxNative checkbox with optional trailing count, used by shop filters.
dropdownBootstrap 5 dropdown. Declarative: data-bs-toggle="dropdown"; positioning, dismissal and keyboard handling come from Bootstrap.
footerFooter system: rows of columns holding about text, link lists, newsletter, contact, social links, copyright and payment marks.
headerHeader system: up to three rows (topbar, main, bottom) of logo, menu, search and icons. Every storefront has its own; any header works on any page.
iconInline SVG sprite reference. Decorative unless a title is given.
inputText input field with label, help text and error message.
modalBootstrap 5 modal. Declarative: data-bs-toggle="modal"; backdrop, focus trap, scroll lock and Escape come from Bootstrap.
navMain navigation with mega menu and simple dropdown panels.
offcanvasBootstrap 5 offcanvas. Declarative: data-bs-toggle="offcanvas"; open it from script with bootstrap.Offcanvas.getOrCreateInstance(el).show().
paginationPage navigation with a computed ellipsis window.
priceCurrent and previous price. Honours a server-formatted priceHtml when present.
product-cardThe most reused component in the product. One block, six variants, no per-niche card.
product-galleryMain image, thumbnails, pointer zoom and lightbox.
quantityStepper with min, max and step. Emits vt:quantity:change.
quick-viewProduct summary in a shared modal, read from the page's own quick-view data. No fetch.
radioNative radio with optional trailing count.
ratingStar rating as one masked bar; the accessible value is text, not the stars.
searchCombobox with suggestions embedded in the page. No fetch.
selectNative select with label, help text and error message.
shop-filterFilters, sorts and paginates the statically rendered grid, with URL state.
skeletonContent placeholder. Always hidden from assistive tech.
spinnerLoading indicator. Decorative unless a label is given.
sticky-barReveals a compact buy bar once the main add-to-cart scrolls away.
stockLow-stock indicator and sold-out state.
swatchesRenders any product attribute — colour, size, material, storage — from one generic shape.
tabsBootstrap 5 tabs. Declarative: data-bs-toggle="tab" with data-bs-target; no Koviera JavaScript behind the switching. Nine looks; every storefront uses sticker, the rest are ready to swap in.
textareaMulti-line text field.
tooltipBootstrap 5 tooltip. Bootstrap does not auto-initialise these, so a six-line wrapper keeps the VT.mount()/destroy() contract.
reviewsProduct reviews: rating summary with a per-star distribution, verified badges, sorting, helpful voting, review photos, merchant responses and an empty state. Sorting and voting are progressive enhancement over server-rendered markup.
spec-sheetGrouped specification table. Feeds the product page, the dense layout and the compare table. The row limit is progressive enhancement over fully rendered markup.
size-guideMeasurement table chosen by the product's category, rendered inline or inside a modal. Sizing is the most common reason a garment is returned.
bundleFrequently-bought-together block for the bundle product layout: companions are pre-ticked, the total recalculates from the DOM, and one button adds the lot.
couponDiscount code entry with inline feedback. Codes and minimums come from settings.commerce and travel with the component; no payment or promotion service is involved.
shipping-estimateDelivery rate picker with windows and prices, read from settings.commerce. A label and a price, not a carrier integration.
free-shipping-barProgress towards the free-shipping threshold, shown in the cart drawer and on the cart page and kept in step by a document-level binding.
form-validationCheckout validation: on blur, then on input once a field has failed, with an error summary at the top linking to each field. Built on the browser's constraint API, so rules live in the markup attributes.
bottom-navMobile-only bottom bar with the five reachable destinations. Absent above the md breakpoint rather than hidden, and every target is at least 44x44 with 8px between.
sheetTurns an offcanvas into a bottom sheet below md: it rises from the bottom, carries a grab handle and can be dismissed by swiping the header as well as by the close button.
back-to-topRound button fixed to the bottom inline-end corner, shown after a screen of scrolling, with a scroll-progress ring on its rim. Returns to the top and moves focus to <main>. Opt-in per demo or page variant with backToTop.

Using a component

The elements page
elements.html — every component, ready to copy

Open html/elements.html. Every component and every variant is on that page. Copy the markup you want and paste it into your page. If your page does not link the component's stylesheet yet, copy that <link> too, into the page's <!-- koviera:css --> block in the order html/css/main.css gives. A component with behaviour has a script as well, and starts itself from its data-vt-component attribute; if the page does not link that script yet, add it to the page's <!-- koviera:js --> block — see "JavaScript", "Adding a component to a page".

Sections

33 sections, worn by the storefronts in 89 different layouts.

A section is a full-width block of a page — a hero, a product grid, a newsletter. A layout is one way of drawing it: the category grid is a mosaic on Fashion, arches on Perfume & Beauty and stickers on Toys — one section, one stylesheet, three looks.

The newsletter
newsletter-01
SectionFamilyLayouts in the demosWhat it is
announcement-barmarketing6Slim promotional strip above the header.
hero-01hero5Large image with the copy beside it, on it, breaking over it, on a floating card, or with a department rail alongside.
category-grid-01category8Featured categories as image cards.
glyph-grid-01category2One drawn outline per term of an attribute - a stone shape, a metal - each linking to the shop filtered by it, with the count the shop will show. After the shape-of-gemstone row on a jeweller's homepage.
price-tiers-01category1Swing tags by budget - under 15, under 25 - each counting what it holds and opening the shop filtered to that ceiling. The way a present is shopped for.
product-grid-01product6Product grid driven by a query rather than a hard-coded list.
product-slider-01product4The product grid selection inside a carousel.
product-feature-01product2One large photograph held against the inline start of the viewport with a product rail beside it running off the opposite edge. After the "member exclusives" block on birkenstock.com.
banner-01marketing3Image plus copy block, overlaid or side by side.
lookbook-01content1Editorial image grid with an uneven rhythm.
instagram-01content1Static image strip linking to a profile. No embed, no network request.
newsletter-01marketing6Email capture block.
hero-sliderhero4Carousel of full-bleed hero slides, each with its own copy, photograph and alignment.
product-tabs-01product4Tabbed product groups, each tab a query against the catalogue. Every panel renders server-side for search engines, so the real cost is limit x tab count — a limit of 8 across three tabs is 24 cards.
product-grid-banner-01product2Product grid with a promotional tile in one cell.
product-masonry-01product1Masonry product layout using CSS columns and mixed image ratios.
product-pair-01product1Two named products presented as one routine: numbered steps, a join between them, and one button that adds both. After the "a daily double act" block on aesop.com.
product-compare-01product1A range shown one at a time: the centred product at full size with its name, notes and price, its neighbours shrunk either side. After the "compare our fragrances" rail on aesop.com.
recently-viewed-01product1Per-visitor history. The catalogue renders hidden and the module reveals what was seen.
category-slider-01category1Category carousel sharing the card with the category grid.
banner-grid-01marketing3Two, three or four promotional tiles in a row.
countdown-01marketing3Deadline promotion with optional product grid.
promo-popup-01marketing1Sale offer as a ticket-shaped dialog that opens by itself after the page loads, with a discount figure, a running clock, a copyable code and a tab that brings it back once closed.
cta-01marketinginner pagesCentred copy block with one or two buttons.
benefits-01marketing4Shipping, returns, support and payment reassurance.
service-tiles-01marketing1A row of flat tiles linking to the service pages: contact, order status, delivery, store finder, returns, help. Tiles are named by key, so the icon, the word and the destination cannot be authored out of step.
blog-grid-01content1Latest posts as a grid or a carousel.
testimonials-01content3Customer quotes with ratings.
brands-01content3Brand wordmark strip. Every mark is authored for this template.
editorial-01content5Image beside a longer copy block.
stats-01content2Four figures about the store, written in the page.
faq-01content2Question list with FAQPage structured data.
sale-strip-01marketing1A band of offers that lands on the bottom edge of the hero above it.

Building a page from sections

html/sections.html shows every layout the storefronts use, each in the palette of the storefront it comes from, and wrapped in an element carrying class="vt-section" data-vt-section="..." — a <section>, or a <div> for a block with no heading, such as a hero or a strip. To add one to a page, copy that element whole and paste it between two sections of your page. Its styles are in html/css/sections/; if the page does not link that file yet, add the <link> to the page's <!-- koviera:css --> block, in the order html/css/main.css gives.

To rearrange a homepage, move its vt-section elements; to remove a block, delete one.

Pages

80 pages. html/index.html is the preview landing and links to every one.

Storefronts

Ten homepages, each with its own palette, header, footer and button hover, and each with a matching shop and product page:

StorefrontHomeShopProduct
Fashionhome-fashion.htmlshop-fashion.htmlproduct-fashion.html
Furniturehome-furniture.htmlshop-furniture.htmlproduct-furniture.html
Electronicshome-electronics.htmlshop-electronics.htmlproduct-electronics.html
Perfume & Beautyhome-perfume.htmlshop-perfume.htmlproduct-perfume.html
Shoeshome-shoes.htmlshop-shoes.htmlproduct-shoes.html
Bagshome-bags.htmlshop-bags.htmlproduct-bags.html
Watcheshome-watches.htmlshop-watches.htmlproduct-watches.html
Organichome-organic.htmlshop-organic.htmlproduct-organic.html
Jewelleryhome-jewelry.htmlshop-jewelry.htmlproduct-jewelry.html
Toyshome-toys.htmlshop-toys.htmlproduct-toys.html

rtl.html is the Fashion homepage right to left.

Shop layouts

PageLayout
shop.htmlSidebar, three columns
shop-grid-4.htmlNo sidebar, four columns
shop-sidebar-end.htmlSidebar on the end edge
shop-list.htmlList view
shop-filter-top.htmlFilters in a drawer
category.htmlCategory archive

The filters work: category, brand, price, colour, size, rating and availability, with sorting, a grid/list switch and pagination. Filter state is written into the URL, so a filtered view can be shared and survives a reload.

Every product is in the HTML. The filter decides what is visible, which keeps the page indexable and readable with JavaScript off. To add a product, copy a <li class="vt-shop__item"> and change it; the filters read the card itself. The numbers beside each filter option ("Women 6") are plain text — update them if you add or remove products.

Product layouts

product-default.html, product-editorial.html and product-dense.html, plus the storefront product pages above. The gallery, price, rating, swatches, quantity, accordion and tabs are the same components everywhere.

product-fashion.html is the one that rearranges the top of the page rather than the column beside it. The gallery runs the full width of the window and as much of its height as the header leaves; the block that names the piece rests on the bottom corner of the photograph as an opaque panel, and colour, size, quantity, the buy button and the panels sit below. On a phone the naming block comes back into flow under the gallery, so the price is never a full swipe away.

Cart, checkout and orders

cart.html, cart-empty.html, checkout.html, checkout-steps.html, checkout-one-page.html, checkout-minimal.html, order-success.html, order-tracking.html.

The cart page, the drawer and the checkout summary all read from one data source, so they cannot disagree.

Shipping rates are the radio buttons in the cart and checkout summary:

HTML
<input type="radio" name="cart-shipping" value="express"
       data-vt-shipping-rate data-vt-price="14" data-vt-label="Express" />

Change data-vt-price and the label, on cart.html, the checkout pages and shipping.html. The free-shipping threshold is data-vt-free-shipping on <body>.

Coupons the demo accepts are listed in a <script type="application/json" data-vt-coupons> block on the same pages — a code, a type (percent, fixed or shipping) and a value. Real coupons must be checked on your server; this list is for the demo only.

Account

login.html, register.html, forgot-password.html, account.html, account-orders.html, account-order.html, account-downloads.html, account-addresses.html, account-details.html.

The account dashboard
account.html

Blog

blog.html, blog-list.html, blog-sidebar.html, blog-masonry.html, blog-single.html, blog-author.html.

Everything else

about.html, contact.html, stores.html, faq.html, search.html, size-guide.html, shipping.html, terms.html, privacy.html, 404.html, coming-soon.html, wishlist.html, compare.html.

And three reference pages for building your store, which you will usually delete before launch: elements.html, sections.html, tokens.html.

Terms and privacy

Each document is a title, an "updated" date and numbered clauses, with a table of contents at the top. The copy shipped with the template is a model, not legal advice. Replace it with a version written for your business before you launch, and delete the notice at the top of the page once you have.

Size guide

size-guide.html holds every chart, one tab each. The centimetres/inches switch converts any column whose heading ends in (cm) and leaves every other column alone. Name a new measurement column the same way and it converts; name it anything else — UK, EU, US — and it is left as a label.

FAQ

faq.html groups its questions in accordions and carries one FAQPage structured-data block covering every question. The search filters the questions already in the page, so editing them gives you a search over your own words with nothing to rebuild. If you change a question, change it in the <script type="application/ld+json"> block after the questions as well.

Forms

The contact, newsletter, account and checkout forms submit nowhere real on purpose — a template cannot ship a backend. Point them at your own handler:

Checkout after submitting an empty form
Submitting with fields missing: a summary at the top, each line a link to its field
HTML
<form action="https://your-handler.example/subscribe" method="post">

Use method="post" for anything carrying a password or personal details. For checkout, connect the form to your payment provider's hosted checkout or tokenised fields before going live, and validate everything again on your server.

The checkout and the contact form share a validation module, data-vt-component="form-validation". It reads the constraint attributes already on the markup (required, type, pattern), so you change validation by editing an attribute, not JavaScript. Two pieces of markup are opt-in:

  • data-vt-label="Your name" on a field sets what the message says instead of the field id.
  • A [data-vt-error-summary] box holding a [data-vt-error-list] gets the list of problems on a failed submit. Leave it out and fields are still marked, but nothing is summarised at the top.

Customising

Everything below is an edit to one of the files in html/css/ or to the pages themselves. Reload and it shows. If your pages link the minified files, run npm run build afterwards — see "Minified build".

Changing colours

Every colour in the template comes from a token. Each page names its palette on the <html> tag:

HTML
<html lang="en" dir="ltr" data-vt-theme="blush">

Sixteen palettes ship: default, blush, luxury, minimal, streetwear, furniture, electronics, mobile, perfume, shoes, bags, watches, organic, jewelry, toys, and showcase — the violet the preview landing and reference pages wear. Each is one file in html/css/themes/, and a page links only its own. To switch a page's palette, change the attribute and the theme's <link> in the page's <!-- koviera:css --> block:

HTML
<link rel="stylesheet" href="./css/themes/blush.css" />

To make your own, copy the file for the palette you are closest to, give it a new name, and change the selector and the semantic tokens, not the primitives:

CSS
[data-vt-theme="mine"] {
  --vt-c-primary: #1c4d3a;
  --vt-c-heading: #101815;
  --vt-c-bg-soft: #f3f6f4;
}

Every button, badge, link and price follows. No component CSS to touch.

Important

any token that carries text must reach 4.5:1 contrast against both --vt-c-bg and --vt-c-bg-soft. html/tokens.html shows every token with a live sample, which is the quickest way to check.

Changing typography

In html/css/tokens/typography.css:

CSS
:root {
  --vt-font-sans: "Your Sans", system-ui, sans-serif;
  --vt-font-serif: "Your Serif", georgia, serif;
}

Sizes use clamp(), so headings scale between small and large screens without breakpoints. Adjust --vt-text-* to retune the scale.

To self-host a font, put the files in html/assets/fonts/ and change the @font-face blocks in html/css/base/fonts.css, keeping font-display: swap. html/assets/fonts/README.txt has the details.

Changing the mode

Type, corners and spacing come from a mode, named on the <html> tag beside the palette. Every page ships in editorial — serif headings, soft rounded corners (10 px on buttons, fields and pictures, 16 px on cards, pill badges), a wide rhythm — so the ten storefronts share one shape and differ only in colour and button hover:

HTML
<html lang="en" dir="ltr" data-vt-theme="toys" data-vt-mode="editorial">
<link rel="stylesheet" href="./css/modes/editorial.css" />

html/css/modes/ holds five more — minimal, commerce, refined, bold and playful. To switch, change the attribute and the mode's <link> together. A mode holds no colour, so any mode works with any palette. Switch every page at once to keep the site consistent.

Section grounds

Each section on a page sits on one of five grounds, set by a class on its <section>. The storefront homepages alternate them so that no two plain sections follow each other, and each has one tinted block about halfway down the page:

ClassesGround
vt-sectionThe page's own ground
vt-section vt-section--softA soft band from edge to edge
vt-section vt-section--darkA dark band
vt-section vt-section--soft vt-section--panelA soft band, kept apart from a flush neighbour
vt-section vt-section--tint vt-section--panelA band washed with the palette's primary colour

To change a section's ground, change its classes. Every ground runs from edge to edge, so changes of ground meet in straight lines.

The logo is text, in the header and footer of every page:

The text logo in the header
The logo is text, set in the heading face of the page's palette
HTML
<a class="vt-logo vt-logo--md" href="index.html" aria-label="Koviera home">
  <span class="vt-logo__text">Koviera</span>
</a>

To use an image, replace the <span> with an <img> carrying explicit width and height — every image in this template has them, which is why layout shift is zero. Change the aria-label to your store's name.

Replacing the images

Every photo slot is assets/images/placeholder.svg. Point the <img> at your file, drop the vt-image--placeholder class, and keep width and height at the image's real proportions:

HTML
<img class="vt-image" src="assets/images/products/linen-shirt.jpg"
     alt="Linen shirt in sand" width="600" height="800" />

On a product card, change "image" inside the data-vt-product attribute of the card's buttons as well — that copy is what the cart, the wishlist and compare display.

The back-to-top button

Every page has one except the preview landing. It stays hidden until the page has been scrolled a screen's worth, so short pages never show it, and it lifts itself clear of the phone's bottom navigation and the product page's sticky buy bar. To remove it from a page, delete the element:

HTML
<button class="vt-back-to-top" type="button" data-vt-component="back-to-top" ...>

The sale popup

Each storefront homepage opens a sale offer a few seconds after it has loaded: a ticket with the discount printed across a photograph, a running clock, a code to copy and a button to the shop. Closed, it stays closed for a day and leaves a small tab in the corner of the screen that brings it back.

It is the block after the drawers, near the end of <body> on each home-*.html:

HTML
<div class="vt-promo-popup" data-vt-section="promo-popup-01" data-vt-component="promo-popup"
  data-vt-options='{"key":"vt-promo-fashion","delay":3,"afterPages":2,"snoozeDays":1,"teaser":true}'>
OptionWhat it does
delaySeconds after the page has loaded before the offer opens
afterPagesThe page of the visit it first opens on; 2 leaves the first page clear, 1 opens on the first
snoozeDaysDays it stays shut once it has been closed or the button followed
teaserfalse drops the corner tab; delete the vt-promo-teaser block too
keyWhere the visitor's choice is remembered; change it to show again

The words, the figure, the code and the link are plain HTML inside the block. A code typed at checkout has to exist in the data-vt-coupons list on the cart and checkout pages (see "Cart, checkout and orders"); every code the demos print is there already. Without a code, delete the vt-promo__code block and the status line after it.

The look follows the page's theme. vt-promo__stub--soft on the stub gives it the theme's soft ground; vt-promo__stub--dark together with vt-section--dark turns it dark.

Add ?promo to the address to open it straight away while editing. Browsers run by automation tools are left alone unless the address carries ?promo. To remove the popup from a page, delete the block and the js/components/promo-popup.js script line.

Changing the button hover

Every button on a page shares one hover, set by a class on <body>:

HTML
<body class="vt-body ... vt-buttons--skew">
ClassThe gestureUsed by
vt-buttons--rippleA disc opens from the centre and fills the buttonFurniture, every page outside a storefront
vt-buttons--skewA slanted panel slides in from the inline startFashion
vt-buttons--riseThe fill wipes straight up from the bottom edgeBags
vt-buttons--shutterTwo bands close in from the top and bottom and meetShoes
vt-buttons--unfoldThe fill opens from the centre line out to both edgesWatches
vt-buttons--scanThe fill crosses the button behind a bright leading edgeElectronics
vt-buttons--bloomThe fill fades in and settles, with no edge and no directionPerfume
vt-buttons--sproutA domed fill rises out of the bottom edge with a slight springOrganic
vt-buttons--gleamThe fill fades in while a band of light crosses the button onceJewellery
vt-buttons--popThe button lifts off the page onto a hard shadowToys

Swap the class to swap the gesture. Only the motion changes: shape, border and weight at rest come from the mode, so every storefront's buttons match until the pointer reaches one. The fills are the same pseudo-element restyled — .btn::before — so none adds markup. Eight of them live in html/css/base/bootstrap-bridge.css, which every page loads; gleam and pop have their own files, base/button-gleam.css and base/button-pop.css, so a page switching to one of those links that file too.

Changing the product card

There is one product card with variants, chosen by a modifier class on the <article>:

HTML
<article class="vt-product-card vt-product-card--overlay" ...>

html/elements.html shows every variant — default, minimal, overlay, horizontal, list and the storefront-specific ones — side by side. Copy the one you want. Optional parts (rating, swatches, quick view, the stock bar) are separate elements inside the card: delete the element to remove the part.

The card's styles are in html/css/components/product-card.css; two storefront variants have files of their own, product-card-plinth.css and product-card-toybox.css, linked only by the pages that use them.

JavaScript

Koviera's own code is vanilla JavaScript, one readable file per component in html/js/. No jQuery anywhere, and no ES modules, so pages work straight from disk. Bootstrap 5 is in html/js/libs/ and its API is on window.bootstrap.

How the files fit together

Each file is a classic script wrapped in a function, so nothing leaks into the page. It registers what it offers on one shared object and reads what it needs from the same object:

JavaScript
(function () {
  'use strict';

  const { isRtl } = window.KovieraModules['core/dom'];

  function carousel(el, options = {}) { ... }

  window.KovieraModules = window.KovieraModules || {};
  window.KovieraModules['components/carousel'] = { carousel };
})();

Each page loads, in dependency order, between <!-- koviera:js --> and <!-- /koviera:js -->, with defer, only what it uses: the core files every page needs, then the file of each component on the page. js/core/app.js comes last: it registers the components whose files the page linked, and starts them.

Tip

Koviera and Bootstrap do not overlap: Koviera components mount from data-vt-component, Bootstrap's from data-bs-*. Never put both on one element.

How components start

A component binds to a data-vt-component attribute, never to a CSS class — so you can rename styling classes freely without breaking behaviour.

HTML
<div class="vt-carousel" data-vt-component="carousel"
     data-vt-options='{"slidesPerView":4}'>

Everything is mounted on load. If you inject markup yourself, mount it:

JavaScript
VT.mount(container);     // start components inside container
VT.destroy(container);   // tear them down before removing it

VT is on window, so this works from a plain script tag too.

Without JavaScript

Every page still reads and navigates with JavaScript switched off. A one-line script in each page's <head> puts vt-js on <html>, and css/utilities/no-js.css styles the page for when it is missing:

The FAQ with JavaScript switched off
JavaScript off: the notice at the top, every answer open
  • Accordions, FAQ answers and every tab panel are open. The one exception is a homepage product-tabs row that sorts one catalogue three ways (new in, best sellers, on sale): it keeps its first list rather than repeating the same products.
  • Carousels become a row you scroll sideways, each slide as wide as the carousel's slidesPerView makes it. The widths are written onto each carousel as --vt-pv and --vt-gap custom properties, one pair per breakpoint — keep them when you copy a carousel.
  • The shop lists the whole catalogue in one column, without the filters.
  • The cart and search icons are links to cart.html and search.html, and the menu icon opens the mobile menu as a link to #vt-mobile-nav.
  • Buttons only a script can answer — add to cart, quick view, wishlist, compare, the pager, carousel arrows — are hidden, and a notice at the top of the page says that the cart, wishlist, compare, filters and checkout need JavaScript.

With JavaScript on, none of these rules match and nothing changes.

Adding a component to a page

Copy the component's markup, then check the page's <!-- koviera:js --> block for its script — js/components/<name>.js, or js/ecommerce/<name>.js for the cart, checkout and shop components. If it is not there:

  1. Find a page that already uses the component — elements.html has almost all of them — and copy the component's <script> line from its block, along with any line your page lacks that the script reads. A script names what it reads at its top: window.KovieraModules['core/dom'] is js/core/dom.js.
  2. Paste them into your page's block, in the order they appear on that page, and always before js/core/app.js.

A page missing a component's script says so in the browser console: VT.mount: no component registered for "carousel". The carousel and the product gallery also need Swiper; see "Heavy libraries".

Available components

back-to-top, bundle, carousel, cart-drawer, cart-page, countdown, coupon, faq-search, form-validation, header, order-confirmation, picker, product-gallery, promo-popup, quantity, recently-viewed, reviews, saved-list, search, sheet, shipping-estimate, shop-filter, spec-sheet, sticky-bar, tabs-indicator, toc, tooltip, unit-switch, video-embed.

Modals, offcanvas drawers, dropdowns, tabs and accordions are plain Bootstrap, started from data-bs-* attributes.

Settings

Set before the scripts load, in the page's <head>:

HTML
<script>
  window.VT_CONFIG = { currency: 'EUR', locale: 'de-DE' };
</script>

currency and locale format every price the script writes — the cart, the drawer, the checkout summary. Prices already written into the HTML are plain text; edit them where they are. The free-shipping threshold the cart counts towards is data-vt-free-shipping on <body>.

Opening a dialog from anywhere

The drawers are Bootstrap offcanvas elements, so any button opens one:

HTML
<button type="button" data-bs-toggle="offcanvas" data-bs-target="#vt-cart-drawer">Cart</button>

The drawers every page carries: #vt-cart-drawer, #vt-search-drawer, #vt-mobile-nav.

Product actions

HTML
<button data-vt-action="add-to-cart"
        data-vt-product='{"id":1001,"name":"...","price":129,"image":"...","url":"..."}'>
Quick view
data-vt-action=“quick-view” opens the product in a modal, built from data already on the page

The button carries a snapshot of the product, exactly as a form post would, so nothing has to be fetched. buy-now, wishlist, compare and quick-view work the same way.

Recently viewed

A product page adds itself to the visitor's history from the element that scopes its buttons:

HTML
<div class="vt-pdp" data-vt-product-scope data-vt-product-id="1024">

The recently-viewed section (on the cart page) then shows those products, newest first. It carries a hidden card for every product that has a page of its own and reveals the ones in the history. If you add product pages, add their products to the section; with a backend, render the visitor's own history instead.

CSS
data-vt-options='{"autoplay":{"delay":5000,"disableOnInteraction":false}}'

The options are Swiper's, but the timing is the carousel's own: one timeout per slide rather than Swiper's Autoplay module, which runs a callback on every animation frame for as long as the page is open. As in Swiper, a carousel stops for good once the visitor drags it, clicks an arrow or a dot, or uses the keys, unless disableOnInteraction is false. It pauses while the tab is hidden, and never starts for a visitor who asked for reduced motion.

Connecting a real backend

Cart, wishlist and compare go through one object, the data source. The one that ships keeps everything in the browser's localStorage (keys start vt:), so the demo works with no server.

To move them onto your own backend, open html/js/core/app.js and find setSource(staticSource). The shipped source is html/js/adapters/static-source.js. Replace staticSource with an object of your own that has the same methods, each returning a promise:

Text
getProducts(query)   getProduct(id)       search(term)
getCart()            addToCart(id, qty, variation)
updateCartItem(key, qty)                  removeCartItem(key)
getWishlist()        toggleWishlist(product)   clearWishlist()
getCompare()         toggleCompare(product)    clearCompare()
compareLimit         (a number: how many products a comparison holds)

No component changes. If your pages link the minified files, run npm run build afterwards.

Heavy libraries

Swiper and GLightbox are linked only by the pages that use them — the carousels and the product gallery. If you add a carousel to a page that has none, add its library before the koviera:js block:

HTML
<script src="./js/libs/swiper.min.js" defer></script>

and ./js/libs/glightbox.min.js plus ./css/libs/glightbox.min.css for a gallery that opens in a lightbox. A page that needs one and lacks it says so in the browser console.

Right to left

Two changes. Set the direction on <html>:

HTML
<html lang="ar" dir="rtl">

and link Bootstrap's mirrored stylesheet instead of the standard one:

HTML
<link rel="stylesheet" href="assets/css/bootstrap.rtl.min.css" />

There is no Koviera RTL stylesheet to add: the same files serve both directions.

Open html/rtl.html to see it: that page is the Fashion homepage with dir="rtl", the mirrored Bootstrap, and nothing else changed.

Why it works

Every Koviera rule uses CSS logical properties — margin-inline-start instead of margin-left, inset-inline-end instead of right, text-align: start instead of left. The browser mirrors them for you. Bootstrap is written with physical properties, which is why it ships its own mirrored build.

The exceptions

Transforms have no logical form, so the template uses a direction token:

CSS
:root      { --vt-dir:  1; }
[dir="rtl"]{ --vt-dir: -1; }

.vt-offcanvas--end .vt-offcanvas__panel {
  transform: translateX(calc(100% * var(--vt-dir)));
}

Use the same token if you add a component that slides or offsets.

Content

Latin text inside an RTL page will have its punctuation rendered on the opposite side. That is the browser applying bidi rules correctly, not a fault. Prices, phone numbers and times are already isolated so they stay left to right.

Minified build

Optional. The template needs nothing installed: every page links readable files, one per component, and works as it is. The build only makes smaller copies of them, for production.

Running it

Requires Node 20 or newer. From the folder that holds package.json:

Terminal
npm install
npm run build          minified copies in html/dist/
npm run build:pages    also one stylesheet per page
npm run build:link     also points every page at the minified files

npm install fetches one package, esbuild. The readable files are never modified.

What it writes

FileWhat it holds
html/dist/css/koviera.min.cssEvery stylesheet, in cascade order
html/dist/js/koviera.min.jsEvery script, in load order
html/dist/css/**, html/dist/js/**Each file minified on its own
html/dist/css/pages/<page>.min.cssbuild:pages and build:link: only the stylesheets that page links
html/dist/js/pages/<page>.min.jsbuild:pages and build:link: only the scripts that page links

Third-party libraries — css/libs/, js/libs/ and Bootstrap in assets/css/ — are already minified and are left out of the bundles, so each can be updated on its own.

Switching the pages over

Each page marks the files the build replaces:

HTML
<!-- koviera:css -->
<link rel="stylesheet" href="./css/tokens/colors.css" />
...
<!-- /koviera:css -->

<!-- koviera:js -->
<script src="./js/core/registry.js" defer></script>
...
<!-- /koviera:js -->

npm run build:link replaces each block with one file:

HTML
<link rel="stylesheet" href="./dist/css/pages/home-fashion.min.css" />
<script src="./dist/js/pages/home-fashion.min.js" defer></script>

Warning

after that a page no longer reads css/ and js/, so keep a copy of html/ from before the link to go on editing.

Where the order comes from

  • CSS — the @import list in html/css/main.css. A new stylesheet goes into that list, in its layer, and into the koviera:css block of the pages that need it.
  • JS — each script registers itself on window.KovieraModules and reads the scripts it depends on from there; the build works out the order from those reads. A new script is picked up on its own; link it inside the koviera:js block after the scripts it reads.

Credits and licensing

The short version

This template contains no photographic assets. Every image slot in this download renders a single placeholder file, assets/images/placeholder.svg, authored for this template.

The pictures visible on the live preview were generated for this demo with Leonardo.Ai and are served by the preview itself. They are not stored in this download and are not redistributed. Nothing in the package requests anything from an external server — it works with no network at all.

What ships in this download

AssetOriginLicenceLicence text
assets/images/placeholder.svgAuthored for this templateCovered by your item licence—
assets/images/brands/*.svgFictional wordmarks, authored for this templateCovered by your item licence—
assets/images/demos/*.webp, assets/images/demos/pages/*.webpScreenshots of this template's own pages, placeholders onlyCovered by your item licence—
assets/favicon.svgAuthored for this templateCovered by your item licence—
assets/fonts/inter-*.woff2InterSIL OFL 1.1assets/fonts/OFL-Inter.txt
assets/fonts/fraunces-*.woff2FrauncesSIL OFL 1.1assets/fonts/OFL-Fraunces.txt
Bootstrap 5getbootstrap.comMITlicenses/bootstrap-MIT.txt
Popperpopper.js.org, bundled with BootstrapMITlicenses/popper-MIT.txt
Swiperswiperjs.comMITlicenses/swiper-MIT.txt
GLightboxbiati-digital/glightboxMITlicenses/glightbox-MIT.txt
Hover and focus effects adapted from UiverseThe authors listed in the licence fileMITlicenses/uiverse-MIT.txt

What does not ship

AssetLicenceWhy it is not here
Preview imagery generated with Leonardo.AiLeonardo.Ai Terms of ServiceMade on the free plan, whose generations are public and non-exclusive — they illustrate the demo and are not ours to hand on

Preview imagery

270 pictures, all generated with Leonardo.Ai for this template, fill the image slots on the live preview. Several slots share one picture, so a product's alternate view or a category tile may repeat an image from the same storefront. They are listed so the provenance of every image can be checked directly.

FileShowsMade with
bags_hero_1.jpgleather holdall on a workbench among tanning toolsLeonardo.Ai
bags_hero_2.jpgleather weekender on a station bench beside the railsLeonardo.Ai
bags_hero_3.jpgtan leather tote on a sunlit stone window seatLeonardo.Ai
electronic_hero_1.jpglaptop and speakers on a desk lit by a warm lamp, in the darkLeonardo.Ai
electronic_hero_2.jpgmonitor, laptop and audio kit on a wooden deskLeonardo.Ai
electronic_hero_3.jpgliving room with a wall-mounted screen and low lightingLeonardo.Ai
electronic_hero_4.jpgphone, earbuds and a speaker on a marble table in soft lightLeonardo.Ai
fashion_hero_1.jpgwoman in a camel coat walking through a pale galleryLeonardo.Ai
fashion_hero_2.jpgwoman in a long coat walking across a courtyardLeonardo.Ai
fashion_hero_3.jpgwoman in a dark suit under a curved concrete canopyLeonardo.Ai
furniture_hero_1.jpgliving room with a curved sofa, low table and lounge chairLeonardo.Ai
jewellery_hero_1.jpggold rings and necklaces on a stone slab in morning lightLeonardo.Ai
jewellery_hero_2.jpggold rings and a chain on marble, portraitLeonardo.Ai
organic_hero_1.jpgharvest table of vegetables and bread by an open windowLeonardo.Ai
organic_hero_2.jpgkitchen counter heaped with fresh produceLeonardo.Ai
organic_hero_3.jpgmarket stall of vegetables and greensLeonardo.Ai
perfume_hero_1.jpgamber fragrance bottle on a cork plinth in warm lightLeonardo.Ai
shoes_hero_1.jpgwhite leather trainers on concrete stepsLeonardo.Ai
shoes_hero_2.jpgbrown trail shoe on a rocky hillside at sunsetLeonardo.Ai
toys_hero_bg.jpgsoft-focus pastel playroom wall, full-width hero backgroundLeonardo.Ai
toys_hero_1.jpgsunlit playroom with wooden toys on the floorLeonardo.Ai
watches_hero_1.jpgsteel field watch on a brown leather strap, on a rockLeonardo.Ai
product_oversized-cotton-jacket.jpgyoung woman posing in white jacketLeonardo.Ai
product_relaxed-linen-shirt.jpgwoman wearing a relaxed oversized white linen shirt, sleeves loosely rolledLeonardo.Ai
product_wide-leg-wool-trousers.jpgmodel in high-waisted wide-leg khaki wool trousers and a striped teeLeonardo.Ai
product_ribbed-merino-knit.jpgclose up showing detail of cream sweaterLeonardo.Ai
product_silk-slip-dress.jpgwoman in an ivory silk slip dress with thin straps, fabric catching the lightLeonardo.Ai
product_heavyweight-cotton-tee.jpgman in a heavyweight plain white cotton t-shirt, boxy fitLeonardo.Ai
product_panelled-track-jacket.jpgman in a panelled retro track jacket in navy and off-whiteLeonardo.Ai
product_utility-cargo-trousers.jpgman in relaxed olive utility cargo trousers with a white shirt, cropped at the torsoLeonardo.Ai
product_boxy-denim-overshirt.jpgman in a boxy mid-blue denim overshirt over a white teeLeonardo.Ai
product_broderie-layer-top.jpgwhite lace layered short sleeve topLeonardo.Ai
product_merino-roll-neck.jpgblack roll neck and dark trousers against brickLeonardo.Ai
product_structured-trench-coat.jpgwoman in a structured stone-beige double-breasted trench coat, belt tiedLeonardo.Ai
product_saga-open-shelving.jpgwhite open shelving unit holding plants and small objectsLeonardo.Ai
product_lofoten-lounge-chair.jpgsoft pink cushioned armchair in stately salonLeonardo.Ai
product_fjord-oak-dining-table.jpgsolid light oak dining table set for two in a bright dining roomLeonardo.Ai
product_bergen-bedside-table.jpgsmall oak bedside table with a drawer next to a made bed, lamp and book on topLeonardo.Ai
product_skagen-floor-lamp.jpgslim brushed-steel floor lamp with a soft linen shade beside a reading chairLeonardo.Ai
product_halden-modular-sofa.jpgnatural white sofa on wood frameLeonardo.Ai
product_nordvik-plank-table.jpgreclaimed timber table and benches under a canopyLeonardo.Ai
product_stege-ladder-shelf.jpgwooden ladder shelf stepped with potted plantsLeonardo.Ai
product_voss-wool-rug.jpgthick undyed grey-cream wool rug with subtle texture on an oak floor, close-upLeonardo.Ai
product_kvist-dining-chair.jpgblack dining chair drawn up to a round timber tableLeonardo.Ai
product_halden-slipper-chair.jpgcantilever chair with thick ochre cushionsLeonardo.Ai
product_verk-workshop-shelf.jpgtimber shelving against a whitewashed wallLeonardo.Ai
product_halix-ultrabook-14.jpgthin silver 14-inch ultrabook laptop half open on a desk beside a coffee cupLeonardo.Ai
product_voltra-flagship-5g.jpgsleek black flagship smartphone held in hand, blurred city behindLeonardo.Ai
product_kaion-studio-headphones.jpgblack over-ear studio headphones, close-up of the cushioned cupsLeonardo.Ai
product_voltra-tab-pro-11.jpgan tablet and stylus laying on a white surfaceLeonardo.Ai
product_halix-precision-mouse.jpghand resting on a low-profile mouse and keyboardLeonardo.Ai
product_halix-studio-display.jpgdesk lit by a wide monitor in a dark roomLeonardo.Ai
product_halix-creator-laptop-16.jpglarge 16-inch space-grey creator laptop seen from a low side angleLeonardo.Ai
product_voltra-pulse-5g.jpgblack phone photographed against a white groundLeonardo.Ai
product_kaion-air-buds.jpgfour earbud charging cases lined up on greyLeonardo.Ai
product_voltra-slate-11.jpgtablet, phone and stylus on a pale deskLeonardo.Ai
product_voltra-pulse-pro.jpgblack phone with its screen lit, on whiteLeonardo.Ai
product_kaion-desk-mic.jpgcondenser microphone tilted over a keyboardLeonardo.Ai
product_auren-neroli-bloom.jpgdramatic black glass perfume bottle with orange blossom petals around itLeonardo.Ai
product_velmont-silk-hand-cream.jpghand cream in a minimal beige tube, a swirl of cream on a fingertip, beige backdropLeonardo.Ai
product_auren-discovery-set.jpgset of small perfume sample vials in an open neutral box, hands holding oneLeonardo.Ai
product_auren-wild-fig-cologne.jpgantique mirror beside pearl earrings and a bottle of perfumeLeonardo.Ai
product_auren-cedar-amber.jpgamber glass perfume bottle on a vanity table, warm woody moodLeonardo.Ai
product_velmont-renewing-face-oil.jpgwater splashing over hot stones beside essential oil and green leavesLeonardo.Ai
product_auren-bathing-gift-box.jpgbath salts, flowers and beauty products laid flat on marbleLeonardo.Ai
product_auren-cedar-candle.jpgwhite glass jar candle on a stool above a bookLeonardo.Ai
product_velmont-botanical-body-oil.jpgstones, flowers and bottles of natural oil arranged togetherLeonardo.Ai
product_auren-petal-gift-set.jpgbrushes and blossoms arranged as a flat layLeonardo.Ai
product_auren-reed-diffuser.jpglit candles, handmade products and folded white towelsLeonardo.Ai
product_velmont-ritual-set.jpgassortment of beauty products laid out on a black tableLeonardo.Ai
product_trail-runner-gtx.jpgathlete tying the laces of grey and orange trail running shoes on a rocky pathLeonardo.Ai
product_suede-derby.jpgpair of tan suede derby shoes leaning against a white wallLeonardo.Ai
product_runner-low-sneaker.jpgfashionable black and white sneakersLeonardo.Ai
product_chelsea-leather-boot.jpgpair of brown leather Chelsea boots on a powder-blue groundLeonardo.Ai
product_court-classic.jpgpair of white leather court sneakers against a wooden slat wallLeonardo.Ai
product_trunk-55.jpgworn leather trunk photographed close upLeonardo.Ai
product_structured-leather-tote.jpgstructured navy leather tote handbag standing uprightLeonardo.Ai
product_canvas-weekender.jpgsand canvas weekender bag with leather handles and trimsLeonardo.Ai
product_minimal-crossbody.jpglight pink purseLeonardo.Ai
product_roll-top-backpack.jpgblack waxed roll-top backpack standing upright on concreteLeonardo.Ai
product_evening-clutch.jpglight tan leather evening clutch with a slim metal claspLeonardo.Ai
product_day-tote.jpgblack leather tote with two strap lengthsLeonardo.Ai
product_leather-duffle-40.jpgbrown leather duffle carried in both handsLeonardo.Ai
product_grained-crossbody.jpgsmall grained crossbody worn at the hipLeonardo.Ai
product_grained-zip-backpack.jpgblack backpack seen from the sideLeonardo.Ai
product_rounded-shoulder-bag.jpgrounded black leather shoulder bagLeonardo.Ai
product_cabin-trunk-45.jpgtan leather suitcase standing against a wallLeonardo.Ai
product_chrono-sport.jpgsteel chronograph sport watch with a black dial and white subdialsLeonardo.Ai
product_field-automatic-38.jpgsteel field watch with a white dial and leather strapLeonardo.Ai
product_diver-300.jpgsteel diver watch with a black rotating bezel on a leather strap among green leavesLeonardo.Ai
product_dress-slim-36.jpgslim gold dress watch with a cream dial on a brown leather strap, on walnut woodLeonardo.Ai
product_halo-morganite-ring.jpgrose gold halo ring with a large pink centre stoneLeonardo.Ai
product_layered-bar-necklace.jpgthree fine gold chains with a bar pendant on marbleLeonardo.Ai
product_baroque-pearl-studs.jpgpearl stud earring worn with dark hairLeonardo.Ai
product_arrow-wrap-cuff.jpgopen gold cuff with an arrow on marbleLeonardo.Ai
product_twin-stacking-rings.jpgtwo rose gold rings stacked on linenLeonardo.Ai
product_turquoise-coin-necklace.jpglayered gold chains with turquoise beads and coins on marbleLeonardo.Ai
product_marble-stone-studs.jpgwhite marbled stone studs on marbleLeonardo.Ai
product_beaded-gold-bangle.jpgbeaded gold bangle on marbleLeonardo.Ai
product_pave-eternity-band.jpggold stone-set band between two studs on a pastel groundLeonardo.Ai
product_amethyst-point-pendant.jpgamethyst point pendant on a silver chainLeonardo.Ai
product_turquoise-drop-earrings.jpgturquoise bead drop earrings on gold hooksLeonardo.Ai
product_stacked-bangle-trio.jpgthree stacked gold bangles with an arrow cuffLeonardo.Ai
product_rainbow-bell-peppers.jpgred, orange, yellow and green peppers piled on a market stallLeonardo.Ai
product_hass-avocados.jpghalved avocado with its stone on pale greenLeonardo.Ai
product_cold-pressed-beet-juice.jpgglass of beetroot juice in front of vegetablesLeonardo.Ai
product_fresh-ginger-root.jpgginger root beside a small heap of ground ginger on blackLeonardo.Ai
product_english-walnuts.jpgwalnuts and cracked shells in a small bowl on whiteLeonardo.Ai
product_apple-oat-bircher.jpgjar of chopped apple over oats and yogurt beside whole applesLeonardo.Ai
product_yellow-bell-pepper.jpgsingle pale yellow bell pepper on whiteLeonardo.Ai
product_green-seedless-grapes.jpghand holding up a bunch of green grapesLeonardo.Ai
product_oat-milk-cold-brew.jpgiced milky coffee in a glass on a wooden tableLeonardo.Ai
product_bird-s-eye-chillies.jpgred chillies on the plant among green leavesLeonardo.Ai
product_cranberry-and-orange-mix.jpgbowl of dried cranberries and orange pieces on a breakfast tableLeonardo.Ai
product_golden-flax-seeds.jpgbowl of flax seeds beside sliced breadLeonardo.Ai
product_stacking-bunny-tower.jpga wooden bunny ring stacker on a white shelfLeonardo.Ai
product_soft-foam-block-set.jpghands building with bright foam blocksLeonardo.Ai
product_classic-brown-teddy.jpga brown teddy bear sitting on a window ledgeLeonardo.Ai
product_wooden-train-set.jpga wooden engine and carriages on a curved trackLeonardo.Ai
product_gear-builder-set.jpgbright interlocking toy gears on pinkLeonardo.Ai
product_mosaic-1000-piece-puzzle.jpga heap of jigsaw pieces on a tableLeonardo.Ai
product_donut-pool-ring.jpga pink sprinkled donut pool ringLeonardo.Ai
product_rainbow-caterpillar.jpga jointed wooden caterpillar in bright beadsLeonardo.Ai
product_rainbow-arch-blocks.jpgtoddler hands among arches and cubes of foamLeonardo.Ai
product_shelf-friends-trio.jpgthree soft toys on a tree-shaped nursery shelfLeonardo.Ai
product_figure-eight-rail-track.jpga wooden figure-eight rail track from aboveLeonardo.Ai
product_hedgehog-peg-board.jpga wooden hedgehog peg board with fruit piecesLeonardo.Ai
cate_phones.jpgwhite phone on a tableLeonardo.Ai
banner_b-03.jpgassorted shirts folded and stackedLeonardo.Ai
blog_b-03.jpga stack of sweaters on a wooden chairLeonardo.Ai
blog_b-01.jpga sweater hanging on a hookLeonardo.Ai
blog_b-02.jpgwhite and brown knit textileLeonardo.Ai
blog_b-04.jpgclose-up of a sweater beside a plantLeonardo.Ai
blog_b-05.jpgwhite and grey knit textileLeonardo.Ai
banner_b-02.jpgassorted shirts on hangersLeonardo.Ai
banner_b-01.jpgclose-up of shirts hanging on a rackLeonardo.Ai
cate_men.jpgman in a white shirt and black jacket against a plain wallLeonardo.Ai
banner_season-shop.jpgbrick fireplace lit in a furnished sitting roomLeonardo.Ai
banner_furniture-workshop.jpgmaker planing a board at a workbench, shavings piled beside itLeonardo.Ai
banner_kids-room.jpgpatterned cushions stacked against cactus wallpaperLeonardo.Ai
banner_registry-table.jpgtable laid with white linen, glassware and flowersLeonardo.Ai
banner_jewelry-chains.jpga row of gold chains hanging against blackLeonardo.Ai
banner_jewelry-display.jpgfine necklaces hanging in a dark displayLeonardo.Ai
banner_jewelry-workshop.jpgjeweller's files and hammers laid out on woodLeonardo.Ai
banner_jewelry-atelier.jpgloose gemstones, a loupe and tweezers from aboveLeonardo.Ai
banner_organic-veg.jpgcabbage, broccoli, radishes and peppers on whiteLeonardo.Ai
banner_organic-pantry.jpgchillies, sliced carrots and herbs in a corner of oakLeonardo.Ai
banner_organic-fruit.jpgbowl of bananas, grapes and pomegranate on linenLeonardo.Ai
banner_organic-deal.jpgchillies and sliced vegetables on oakLeonardo.Ai
banner_organic-field.jpgcarrots with green tops lying on dark soilLeonardo.Ai
banner_d-01.jpgwooden ladder, stool and plant in a roomLeonardo.Ai
cate_shoes.jpgpair of brown leather bootsLeonardo.Ai
product_toys-montessori.jpgtoddlers at a table of wooden learning toysLeonardo.Ai
banner_watches-workshop.jpgwatchmaker in a loupe working on a movement in its holderLeonardo.Ai
banner_watches-movement.jpgblack and white macro of a watch movement before a serviceLeonardo.Ai
banner_watches-straps.jpgsix rubber watch straps with steel buckles, laid in a rowLeonardo.Ai
cate_networking.jpgpatch panel with rows of network cablesLeonardo.Ai
cate_cables.jpgorange patch leads plugged into a switchLeonardo.Ai
cate_servers.jpgclose-up of a labelled patch panelLeonardo.Ai
cate_security.jpgsecurity camera mounted on a patterned facadeLeonardo.Ai
cate_kitchen.jpgespresso machine on a stone kitchen counterLeonardo.Ai
cate_personal-care.jpgrow of electric toothbrushes against orangeLeonardo.Ai
cate_gaming.jpggaming mouse and glasses on a laptopLeonardo.Ai
hero_bags.jpgtan leather satchel resting on a made bedLeonardo.Ai
hero_laptop.jpgopen laptop alone on a black desk in a bare roomLeonardo.Ai
hero_fashion-luxury.jpgtweed coat on a tailor's dress formLeonardo.Ai
hero_streetwear-2.jpglone figure walking past a pink and white wallLeonardo.Ai
hero_streetwear-3.jpgmodel in navy silk against a dark studio groundLeonardo.Ai
hero_shoes.jpgnavy suede boots against a yellow textured floorLeonardo.Ai
hero_shoes-2.jpgwooden shoe lasts hung in rows on a wallLeonardo.Ai
hero_toys-alt.jpga child hopping across a chalked hopscotch gridLeonardo.Ai
hero_watches.jpgplain-dialled wristwatch on slatted wood, under hard shadowLeonardo.Ai
product_poplin-overshirt.jpgPoplin OvershirtLeonardo.Ai
product_oxford-shirt.jpgOxford ShirtLeonardo.Ai
product_embroidered-sleeve-blouse.jpgEmbroidered Sleeve BlouseLeonardo.Ai
product_cutwork-sleeve-top.jpgCutwork Sleeve TopLeonardo.Ai
product_cashmere-crew-neck.jpgCashmere Crew NeckLeonardo.Ai
product_longline-wool-cardigan.jpgLongline Wool CardiganLeonardo.Ai
product_brushed-roll-neck.jpgBrushed Roll NeckLeonardo.Ai
product_high-rise-denim.jpgHigh Rise DenimLeonardo.Ai
product_brushed-flannel-shirt.jpgBrushed Flannel ShirtLeonardo.Ai
product_boxy-jersey-tee.jpgBoxy Jersey TeeLeonardo.Ai
product_fine-gauge-knit.jpgFine Gauge KnitLeonardo.Ai
product_unstructured-blazer.jpgUnstructured BlazerLeonardo.Ai
product_unstructured-blazer-2.jpgUnstructured Blazer, alternate viewLeonardo.Ai
product_unstructured-blazer-3.jpgUnstructured Blazer, alternate viewLeonardo.Ai
product_unstructured-blazer-4.jpgUnstructured Blazer, alternate viewLeonardo.Ai
product_saga-open-shelving-2.jpgSaga Open Shelving, alternate viewLeonardo.Ai
product_saga-open-shelving-3.jpgSaga Open Shelving, alternate viewLeonardo.Ai
product_saga-open-shelving-4.jpgSaga Open Shelving, alternate viewLeonardo.Ai
product_halix-ultrabook-14-2.jpgHalix Ultrabook 14, alternate viewLeonardo.Ai
product_halix-ultrabook-14-3.jpgHalix Ultrabook 14, alternate viewLeonardo.Ai
product_halix-ultrabook-14-4.jpgHalix Ultrabook 14, alternate viewLeonardo.Ai
product_kaion-shelf-speaker.jpgKaion Shelf SpeakerLeonardo.Ai
product_kaion-wireless-earbuds.jpgKaion Wireless EarbudsLeonardo.Ai
product_velmont-renewing-face-oil-2.jpgVelmont Renewing Face Oil, alternate viewLeonardo.Ai
product_velmont-renewing-face-oil-3.jpgVelmont Renewing Face Oil, alternate viewLeonardo.Ai
product_velmont-renewing-face-oil-4.jpgVelmont Renewing Face Oil, alternate viewLeonardo.Ai
product_chelsea-leather-boot-2.jpgChelsea Leather Boot, alternate viewLeonardo.Ai
product_chelsea-leather-boot-3.jpgChelsea Leather Boot, alternate viewLeonardo.Ai
product_chelsea-leather-boot-4.jpgChelsea Leather Boot, alternate viewLeonardo.Ai
product_diver-300-2.jpgDiver 300, alternate viewLeonardo.Ai
product_diver-300-3.jpgDiver 300, alternate viewLeonardo.Ai
product_diver-300-4.jpgDiver 300, alternate viewLeonardo.Ai
product_grained-flap-bag.jpgGrained Flap BagLeonardo.Ai
product_chain-mini-bag.jpgChain Mini BagLeonardo.Ai
product_card-crossbody.jpgCard CrossbodyLeonardo.Ai
product_everyday-backpack.jpgEveryday BackpackLeonardo.Ai
product_flap-backpack.jpgFlap BackpackLeonardo.Ai
product_flap-backpack-2.jpgFlap Backpack, alternate viewLeonardo.Ai
product_flap-backpack-3.jpgFlap Backpack, alternate viewLeonardo.Ai
product_flap-backpack-4.jpgFlap Backpack, alternate viewLeonardo.Ai
product_weekend-duffle.jpgWeekend DuffleLeonardo.Ai
product_voltra-edge-compact.jpgVoltra Edge CompactLeonardo.Ai
product_kaion-nova.jpgKaion NovaLeonardo.Ai
product_kaion-nova-2.jpgKaion Nova, alternate viewLeonardo.Ai
product_kaion-nova-3.jpgKaion Nova, alternate viewLeonardo.Ai
product_kaion-nova-4.jpgKaion Nova, alternate viewLeonardo.Ai
product_kaion-nova-lite.jpgKaion Nova LiteLeonardo.Ai
product_kaion-canvas-11.jpgKaion Canvas 11Leonardo.Ai
product_bunched-garden-carrots.jpgBunched Garden CarrotsLeonardo.Ai
product_heirloom-rainbow-carrots.jpgHeirloom Rainbow CarrotsLeonardo.Ai
product_tenderstem-broccoli.jpgTenderstem BroccoliLeonardo.Ai
product_green-asparagus-bunch.jpgGreen Asparagus BunchLeonardo.Ai
product_vine-ripened-tomatoes.jpgVine Ripened TomatoesLeonardo.Ai
product_mixed-salad-leaves.jpgMixed Salad LeavesLeonardo.Ai
product_asparagus-tips.jpgAsparagus TipsLeonardo.Ai
product_red-globe-grapes.jpgRed Globe GrapesLeonardo.Ai
product_navel-oranges.jpgNavel OrangesLeonardo.Ai
product_citrus-harvest-box.jpgCitrus Harvest BoxLeonardo.Ai
product_gala-apples.jpgGala ApplesLeonardo.Ai
product_wild-blueberries.jpgWild BlueberriesLeonardo.Ai
product_fresh-raspberries.jpgFresh RaspberriesLeonardo.Ai
product_seedless-watermelon.jpgSeedless WatermelonLeonardo.Ai
product_persian-limes.jpgPersian LimesLeonardo.Ai
product_sunrise-papaya.jpgSunrise PapayaLeonardo.Ai
product_lemon-ginger-tonic.jpgLemon Ginger TonicLeonardo.Ai
product_purple-garlic-bulbs.jpgPurple Garlic BulbsLeonardo.Ai
product_golden-flax-seeds-2.jpgGolden Flax Seeds, alternate viewLeonardo.Ai
product_golden-flax-seeds-3.jpgGolden Flax Seeds, alternate viewLeonardo.Ai
product_golden-flax-seeds-4.jpgGolden Flax Seeds, alternate viewLeonardo.Ai
product_wholegrain-cereal-hoops.jpgWholegrain Cereal HoopsLeonardo.Ai
product_pave-eternity-band-2.jpgPave Eternity Band, alternate viewLeonardo.Ai
product_pave-eternity-band-3.jpgPave Eternity Band, alternate viewLeonardo.Ai
product_pave-eternity-band-4.jpgPave Eternity Band, alternate viewLeonardo.Ai
product_silver-eternity-band.jpgSilver Eternity BandLeonardo.Ai
product_classic-wedding-band-pair.jpgClassic Wedding Band PairLeonardo.Ai
product_aqua-crystal-pendant.jpgAqua Crystal PendantLeonardo.Ai
product_dove-chain-necklace.jpgDove Chain NecklaceLeonardo.Ai
product_love-knot-stud-set.jpgLove Knot Stud SetLeonardo.Ai
product_swallow-studs.jpgSwallow StudsLeonardo.Ai
product_tassel-charm-bangle.jpgTassel Charm BangleLeonardo.Ai
product_anchor-chain-bracelet.jpgAnchor Chain BraceletLeonardo.Ai
product_wiggle-worm-pull-along.jpgWiggle Worm Pull-AlongLeonardo.Ai
product_wiggle-worm-pull-along-2.jpgWiggle Worm Pull-Along, alternate viewLeonardo.Ai
product_wiggle-worm-pull-along-3.jpgWiggle Worm Pull-Along, alternate viewLeonardo.Ai
product_wiggle-worm-pull-along-4.jpgWiggle Worm Pull-Along, alternate viewLeonardo.Ai
product_alphabet-letter-blocks.jpgAlphabet Letter BlocksLeonardo.Ai
product_playroom-block-bucket.jpgPlayroom Block BucketLeonardo.Ai
product_big-hug-teddy.jpgBig Hug TeddyLeonardo.Ai
product_holiday-teddy-gift-box.jpgHoliday Teddy Gift BoxLeonardo.Ai
product_tip-up-truck-duo.jpgTip-Up Truck DuoLeonardo.Ai
product_little-doctor-play-kit.jpgLittle Doctor Play KitLeonardo.Ai
product_wind-up-tin-robot.jpgWind-Up Tin RobotLeonardo.Ai
product_family-bingo-night.jpgFamily Bingo NightLeonardo.Ai
product_dice-quest-board-game.jpgDice Quest Board GameLeonardo.Ai
product_tumble-tower.jpgTumble TowerLeonardo.Ai
product_pool-party-float-pack.jpgPool Party Float PackLeonardo.Ai
product_red-bath-pool-boat.jpgRed Bath & Pool BoatLeonardo.Ai
product_foldover-crossbody.jpgFoldover CrossbodyLeonardo.Ai

Replacing the imagery

Put your own files in html/assets/images/, point each <img> at them and drop its vt-image--placeholder class. On a product card, change "image" in the buttons' data-vt-product as well, so the cart and the wishlist show the same picture. SETUP.txt §5 walks through it.