love-ecommerce-template 1.0.0 · SDK 1.2.0

Theme system

A template's look comes from three places: branding in template.json (turned into CSS custom properties), the shared stylesheets (core.css always, kit.css when assets.kit is true) and your own stylesheet.

Branding → CSS custom properties

Colours, fonts and corner radius. Exposed to the browser as config.branding and converted into CSS custom properties in a <style id="sf-theme-tokens"> tag that core.css / kit.css (and your CSS) can use. store/theme-assets.js:61 server.js:768

template.jsonCSS propertyFormatDescriptionSource
branding.primaryColor--sf-primarycolor
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Main brand colour. Also the default SweetAlert2 confirm-button colour when script.js sets no buttonColor. Sets the CSS custom property --sf-primary (hex colours only; anything else is ignored).store/theme-assets.js:64
branding.secondaryColor--sf-secondarycolor
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Secondary colour. Sets the CSS custom property --sf-secondary (hex colours only; anything else is ignored).store/theme-assets.js:65
branding.accentColor--sf-accentcolor
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Accent colour. Sets the CSS custom property --sf-accent (hex colours only; anything else is ignored).store/theme-assets.js:66
branding.textColor--sf-inkcolor
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Body text colour. Sets the CSS custom property --sf-ink (hex colours only; anything else is ignored).store/theme-assets.js:67
branding.surfaceColor--sf-surfacecolor
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Card / panel background. Sets the CSS custom property --sf-surface (hex colours only; anything else is ignored).store/theme-assets.js:68
branding.mutedSurfaceColor--sf-muted-surfacecolor
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Muted background for alternate sections. Sets the CSS custom property --sf-muted-surface (hex colours only; anything else is ignored).store/theme-assets.js:69
branding.onPrimaryColor--sf-on-primarycolor
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
Text colour on top of the primary colour. Sets the CSS custom property --sf-on-primary (hex colours only; anything else is ignored).store/theme-assets.js:70
branding.fontFamily--sf-font-bodyfont-stack
^[A-Za-z0-9 ,'"-]{1,160}$
Body font stack. Sets --sf-font-body. Must match ^[A-Za-z0-9 ,'"-]{1,160}$ (no url() or semicolons).store/theme-assets.js:71
branding.headingFont--sf-font-headingfont-stack
^[A-Za-z0-9 ,'"-]{1,160}$
Heading font stack. Sets --sf-font-heading.store/theme-assets.js:72
branding.displayFont--sf-font-displayfont-stack
^[A-Za-z0-9 ,'"-]{1,160}$
Display font stack. Sets --sf-font-display.store/theme-assets.js:73
branding.radius--sf-radiusstring
^\d{1,2}px$
Corner radius such as "8px" (1–2 digits + px). Sets --sf-radius.store/theme-assets.js:74

Use them in styles.css, e.g. .btn-primary { background: var(--sf-primary); }. The Studio's Theme panel edits these values and shows them live in the preview.

Fonts

Fonts are self-hosted by the application. List keys in assets.fonts; the page loads /assets/fonts/<key>.css. External font services are blocked by the CSS sanitizer and the CSP.

KeyFamilyWeightsStylesheet
albert-sansAlbert Sans100 900/assets/fonts/albert-sans.css
cormorant-garamondCormorant Garamond300 700/assets/fonts/cormorant-garamond.css
exoExo100 900/assets/fonts/exo.css
forumForum400/assets/fonts/forum.css
frauncesFraunces100 900/assets/fonts/fraunces.css
interInter100 900/assets/fonts/inter.css
jostJost100 900/assets/fonts/jost.css
manropeManrope200 800/assets/fonts/manrope.css
nunitoNunito200 1000/assets/fonts/nunito.css
pacificoPacifico400/assets/fonts/pacifico.css
playfair-displayPlayfair Display400 900/assets/fonts/playfair-display.css
pt-sansPT Sans400, 700/assets/fonts/pt-sans.css
robotoRoboto100 900/assets/fonts/roboto.css
rubikRubik300 900/assets/fonts/rubik.css

Layout kit

true loads /assets/storefront/kit.css (the layout kit used by the newer templates). store/theme-assets.js:88 Installed templates using it: beauty, boutique, corporate, couture, electro, grocer, homeliving, organic.

Words (labels)

The storefront engine's words. Override any of them in template.json labels or in script.js window.StorefrontTheme.labels (template.json wins).

LabelDefault
cartCart
cartLowercart
addToCartAdd to Cart
viewCartView Cart
wishlistWishlist
wishlistLowerwishlist
saveItemSave
brandBrand
brandsBrands
allBrandsAll Brands
shopByBrandShop by Brand
productProduct
productsProducts
browseProductsBrowse Products
categoryCategory
categoriesCategories
emptyCartTitleYour cart is empty
emptyCartTextBrowse the store and add something you love.
emptyWishlistTitleNothing saved yet
emptyWishlistTextTap the heart on any product to keep it here.
continueShoppingContinue Shopping
checkoutCheckout
deliveryDelivery
storeWordstore
chooseStoreTitleChoose your store
chooseStoreTextPrices, availability and delivery options depend on the store you shop from.
currencyIconfa-shopping-bag

Icons

IconDefault Font Awesome class
cartfa-shopping-cart
wishlistfa-heart
emptyCartfa-shopping-basket
browsefa-store
categoryDefaultfa-tag
brandfa-award

Category tiles pick an icon by keyword (67 keywords built in, e.g. vegetable, fruit, grain, dairy, milk, meat, fish, seafood); add more with StorefrontTheme.categoryIcons.

Generated 2026-10-01 11:59 UTC from the application source (contract 7075c14c24bbaf06).