love-ecommerce-template 1.0.0 · SDK 1.2.0

Template files

The template folder

templates/<name>/ inside the application (one folder per template)

Files

FileRequiredRoleDescriptionSource
template.jsonyesconfigConfiguration. A folder without a readable template.json is skipped by the loader ("Error loading template").template-engine.js:68 template-engine.js:74
index.htmlyesmarkupThe page markup rendered by the template engine. The loader accepts a template without it but logs "will render empty" and the storefront has no content.template-engine.js:81 template-engine.js:92
styles.css
or style.css
nostylesTemplate stylesheet, served sanitized at /templates/<name>/styles.css and linked after the shared styles. style.css is accepted as an alternative name (styles.css wins on /styles.css, style.css wins on /style.css; the page links /style.css).server.js:1084
script.jsnoscriptTemplate script, served sanitized at /templates/<name>/script.js and loaded (deferred) BEFORE the shared engine, so it can define window.StorefrontTheme.server.js:810
theme.jsonnometaOptional installation metadata (id, slug, name, version, previewImage) used to match the store's configured theme to this folder.template-engine.js:88
image/noassetsImages served at /image/<path> for the ACTIVE template (sub-folders allowed).server.js:1103

image/

See Assets.

theme.json

Optional installation metadata. The application reads it (if present) to match pos_setting.theme.activeThemeId / activeThemeName to this template and to report the installed version. It does not affect styling.

KeyTypeDefaultStatusDescription
idstringreadPlatform template id (e.g. "TPL-…"). activeThemeId may match it.
template-engine.js:589 template-engine.js:615
namestringreadDisplay name. activeThemeName may match it.
template-engine.js:591 template-engine.js:616
slugstringreadSlug. activeThemeId may match it; the admin "switch" stores it as activeThemeId.
^[a-zA-Z0-9_-]{1,64}$
template-engine.js:590 template-engine.js:615
versionstringreadInstalled version (wins over template.json version).
server.js:378 server.js:1231
previewImagestring""readPreview image URL shown in the admin template list.
template-engine.js:594
sourceUrlstring""not readNot read by the application.
installedAtstring""not readNot read by the application (written by the platform installer).
descriptionstring""not readNot read by the application.
Generated 2026-10-01 11:59 UTC from the application source (contract 7075c14c24bbaf06).