love-ecommerce-template 1.0.0 · SDK 1.2.0

Configuration (template.json)

Template configuration. Required: the application only loads folders that contain a readable template.json. template-engine.js:68 template-engine.js:74

String values in template.json have <…> tags, "javascript:" and on…= removed before reaching the browser.

The Status column says whether the application reads a key: read (evidence linked), passed through (copied to the browser config but not used there), not read (accepted but ignored — the validator reports these as info). The Templates column counts the installed templates (out of 15) that set the key.

Keys

KeyTypeDefaultStatusTemplatesDescription
displayNamestringread0/15Name shown in the admin template list (GET /api/templates) and stored as the active theme name when an admin switches to this template.
template-engine.js:591 server.js:1230
descriptionstringread0/15Description shown in the admin template list when set (falls back to website.description).
template-engine.js:592
versionstringread0/15Template version. Used for the admin list and the installed-version check when theme.json has no version.
template-engine.js:593 server.js:378
websiteobjectread15/15Store identity defaults supplied by the template.
server.js:641
descriptionstring""read15/15Tagline used for the {DESCRIPTION} placeholder, the <meta name="description"> tag and the browser config when the store record has no description of its own.
server.js:652 server.js:755
namestring""not read15/15Not read by the application — the store name always comes from the store record (pos_setting.store.name).
faviconstring""not read15/15Not read by the application.
currencystring""not read15/15Not read by the application — the currency comes from the store record.
languagestring"en"not read15/15Not read by the application (the page is always lang="en").
yearstring""not read15/15Not read by the application — {YEAR} is the current year.
brandingobjectread15/15Colours, 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
primaryColorstring
color
read15/15Main 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).
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
store/theme-assets.js:64
secondaryColorstring
color
read15/15Secondary colour. Sets the CSS custom property --sf-secondary (hex colours only; anything else is ignored).
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
store/theme-assets.js:65
accentColorstring
color
read15/15Accent colour. Sets the CSS custom property --sf-accent (hex colours only; anything else is ignored).
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
store/theme-assets.js:66
textColorstring
color
read8/15Body text colour. Sets the CSS custom property --sf-ink (hex colours only; anything else is ignored).
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
store/theme-assets.js:67
surfaceColorstring
color
read0/15Card / panel background. Sets the CSS custom property --sf-surface (hex colours only; anything else is ignored).
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
store/theme-assets.js:68
mutedSurfaceColorstring
color
read8/15Muted background for alternate sections. Sets the CSS custom property --sf-muted-surface (hex colours only; anything else is ignored).
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
store/theme-assets.js:69
onPrimaryColorstring
color
read0/15Text colour on top of the primary colour. Sets the CSS custom property --sf-on-primary (hex colours only; anything else is ignored).
^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
store/theme-assets.js:70
fontFamilystring
font-stack
read15/15Body font stack. Sets --sf-font-body. Must match ^[A-Za-z0-9 ,'"-]{1,160}$ (no url() or semicolons).
^[A-Za-z0-9 ,'"-]{1,160}$
store/theme-assets.js:71
headingFontstring
font-stack
read9/15Heading font stack. Sets --sf-font-heading.
^[A-Za-z0-9 ,'"-]{1,160}$
store/theme-assets.js:72
displayFontstring
font-stack
read5/15Display font stack. Sets --sf-font-display.
^[A-Za-z0-9 ,'"-]{1,160}$
store/theme-assets.js:73
radiusstringread15/15Corner radius such as "8px" (1–2 digits + px). Sets --sf-radius.
^\d{1,2}px$
store/theme-assets.js:74
homeobjectread15/15Home page switches read by the storefront engine.
server.js:769
showHerobooleantrueread15/15Set to false to hide #heroSlider.
public/assets/storefront/engine.js:2942
showFeaturedbooleantrueread15/15Set to false to skip loading featured products into #homeFeaturedGrid.
public/assets/storefront/engine.js:1194
showLatestProductsbooleantrueread15/15Set to false to skip loading #homeProductsGrid.
public/assets/storefront/engine.js:1204
showCategoriesbooleantrueread15/15Set to false to hide #homeCategoriesSection.
public/assets/storefront/engine.js:1247 public/assets/storefront/engine.js:1320
showBrandsbooleantrueread15/15Set to false to hide #homeBrandsSection.
public/assets/storefront/engine.js:1262 public/assets/storefront/engine.js:1321
productsPerSectionnumber8read15/15How many products the home grids request.
min 1, max 48
public/assets/storefront/engine.js:1195 public/assets/storefront/engine.js:1205
productsobjectread15/15Products page filter switches.
server.js:773
productsPerPagenumber20passed through15/15Not read by the storefront engine (it always requests 20 per page).
showFiltersbooleantruepassed through15/15Not read by the storefront engine.
showBrandFilterbooleantrueread15/15Set to false to hide the brand filter (#brandSelect).
public/assets/storefront/engine.js:1045
showCategoryFilterbooleantrueread15/15Set to false to hide the category filter (#categorySelect).
public/assets/storefront/engine.js:1037
showSubcategoryFilterbooleantrueread15/15Set to false to hide the subcategory filter (#subcategorySelect).
public/assets/storefront/engine.js:1070
shippingobjectread15/15Delivery options the template allows. The server combines them with the store settings and delivery areas.
server.js:313
enabledbooleantrueread15/15Set to false to disable delivery choices entirely.
server.js:318
storePickupEnabledbooleantrueread15/15Offer "Store Pickup" at checkout.
server.js:319
storePickupFeenumber0read15/15Fee charged for store pickup, in the store currency.
min 0
server.js:320
standardDeliveryEnabledbooleantrueread15/15Offer delivery to an address (also needs delivery areas in the store data).
server.js:314
paymentobjectread15/15Payment switches applied on the server when listing payment methods.
server.js:361
enabledbooleantrueread15/15Set to false to disable online payment methods.
server.js:363
cashOnDeliveryEnabledbooleantrueread15/15Set to false to hide Cash on Delivery.
server.js:364
securityobjectread15/15Present in existing templates. Only captcha.minFormTimeMs is passed to the browser config; nothing here is read by engine.js (CAPTCHA is decided by the server).
captchaobjectread15/15CAPTCHA settings.
enabledbooleantruenot read15/15Not read — the browser config always receives enabled:false and the server decides when CAPTCHA is required.
loginbooleantruenot read15/15Not read.
registrationbooleantruenot read15/15Not read.
typestring"server"not read15/15Not read.
minFormTimeMsnumber1500passed through15/15Copied to the browser config; not read by engine.js.
server.js:787
socialobjectread15/15Social profile links shown in #footerSocialLinks. Only https:// URLs are rendered; empty values are skipped.
public/assets/storefront/engine.js:3049
facebookstring
https-url
""read15/15Facebook URL.
public/assets/storefront/engine.js:3050
instagramstring
https-url
""read15/15Instagram URL.
public/assets/storefront/engine.js:3050
twitterstring
https-url
""read15/15Twitter URL.
public/assets/storefront/engine.js:3050
x-twitterstring
https-url
""read0/15X URL.
public/assets/storefront/engine.js:3050
tiktokstring
https-url
""read0/15TikTok URL.
public/assets/storefront/engine.js:3050
linkedinstring
https-url
""read15/15LinkedIn URL.
public/assets/storefront/engine.js:3050
youtubestring
https-url
""read15/15YouTube URL.
public/assets/storefront/engine.js:3050
pintereststring
https-url
""read0/15Pinterest URL.
public/assets/storefront/engine.js:3050
whatsappstring
https-url
""read0/15WhatsApp URL.
public/assets/storefront/engine.js:3050
featuresobjectread15/15Feature switches read by the storefront engine.
server.js:795
wishlistbooleantrueread15/15Set to false to remove wishlist buttons from product cards and the product page.
public/assets/storefront/engine.js:880 public/assets/storefront/engine.js:1628
featuredProductsbooleantrueread15/15Set to false to stop loading featured products.
public/assets/storefront/engine.js:1194
shopByCategorybooleantrueread15/15Set to false to hide the home category grid.
public/assets/storefront/engine.js:1247
shopByBrandbooleantrueread15/15Set to false to hide the home brand grid.
public/assets/storefront/engine.js:1262
couponsbooleantrueread15/15Set to false to hide the coupon box in the cart.
public/assets/storefront/engine.js:1893
reviewsbooleantruepassed through15/15Not read by engine.js.
guestCartbooleantruepassed through15/15Not read by engine.js.
contentobjectread15/15Optional merchandising content. The server validates it (store/theme-assets.js publicContent) and blocks that have no content are hidden by the engine.
server.js:801
announcementstring""read15/15Text for [data-sf-announcement] / .announcement-bar (max 180 characters).
max 180 chars
store/theme-assets.js:118
heroSlidesarrayread15/15Replaces the slides inside #heroSlider (max 5). The first .hero-slide in your HTML is used as the slide template.
max 5 items
store/theme-assets.js:119 public/assets/storefront/engine.js:2958
eyebrowstring""read0/15Small text above the title (max 80).
max 80 chars
read with its list
store/theme-assets.js:119
titlestring""read0/15Slide title (required, max 120). Slides without a title are dropped.
max 120 chars, required
read with its list
store/theme-assets.js:119
textstring""read0/15Paragraph (max 220).
max 220 chars
read with its list
store/theme-assets.js:119
ctastring""read0/15Button text (max 40).
max 40 chars
read with its list
store/theme-assets.js:119
imagestring
safe-image
""read0/15Background image: /image/…, /assets/… or /uploads/… path to a png/jpg/webp/svg/gif.
read with its list
store/theme-assets.js:119
promotionsarrayread15/15Promotion cards for .promo-banner / .two-col-banner / [data-sf-promo] items (max 6). Without promotions the engine fills these slots with the store's categories.
max 6 items
store/theme-assets.js:124 public/assets/storefront/engine.js:1358
eyebrowstring""read0/15Small text (max 60).
max 60 chars
read with its list
store/theme-assets.js:124
titlestring""read0/15Title (required, max 80).
max 80 chars, required
read with its list
store/theme-assets.js:124
textstring""read0/15Text (max 160).
max 160 chars
read with its list
store/theme-assets.js:124
ctastring""read0/15Link text (max 30).
max 30 chars
read with its list
store/theme-assets.js:124
imagestring
safe-image
""read0/15/image/…, /assets/… or /uploads/… image path.
read with its list
store/theme-assets.js:124
categorystring""read0/15Category name: the card links to that category.
max 80 chars
read with its list
store/theme-assets.js:124
uspsarrayread15/15Service highlights for [data-sf-usps] / .usp-strip (max 6). Without them the engine shows facts from the selected store (pickup, delivery, hours, payments, phone).
max 6 items
store/theme-assets.js:129 public/assets/storefront/engine.js:1402
iconstring"check"read0/15Font Awesome icon name without "fa-" (e.g. "truck-fast").
^[a-z0-9-]{2,40}$
read with its list
store/theme-assets.js:129
titlestring""read0/15Title (required, max 60).
max 60 chars, required
read with its list
store/theme-assets.js:129
textstring""read0/15Text (max 120).
max 120 chars
read with its list
store/theme-assets.js:129
testimonialsarrayread15/15Quotes for [data-sf-testimonials] / .testimonial-section (max 8). The section stays hidden when empty: the engine never invents reviews.
max 8 items
store/theme-assets.js:134 public/assets/storefront/engine.js:1437
quotestring""read0/15Quote (required, max 400).
max 400 chars, required
read with its list
store/theme-assets.js:134
namestring""read0/15Name (required, max 60).
max 60 chars, required
read with its list
store/theme-assets.js:134
rolestring""read0/15Role / location (max 60).
max 60 chars
read with its list
store/theme-assets.js:134
newsletterbooleanfalseread15/15Show newsletter blocks (.newsletter-section, [data-sf-section="newsletter"], .footer-newsletter). Hidden unless true.
store/theme-assets.js:140 public/assets/storefront/engine.js:3056
labelsobjectread0/15Overrides for the words the engine uses (merged over script.js StorefrontTheme.labels). Keys are listed in the Runtime API section.
server.js:802 public/assets/storefront/engine.js:85
assetsobjectread15/15Shared assets loaded by the page head.
store/theme-assets.js:80
kitbooleanfalseread15/15true loads /assets/storefront/kit.css (the layout kit used by the newer templates).
store/theme-assets.js:88
fontsarray[]read15/15Self-hosted fonts to load (keys of /assets/fonts/<key>.css that exist in the application).
store/theme-assets.js:81

What reaches the browser

The server builds a configuration object for the storefront engine and prints it as script#love-config-json (type="application/json"). Top-level keys: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21 server.js:752

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