assets folder

Contains all frontend resources: styles, interaction scripts, and media (images/icons/videos).

Typical contents

• *.css: e.g., style.css for page and widget styling.
• *.js: e.g., main.js, cart.js, product.js, search.js, sidebar.js, pagination.js, swiper-init.js for interaction and data handling.
• Media (.webp, .svg, .mp4): product/banner images, icons, or promo videos.

How to include

• In layout.njk or any Nunjucks template, use the assets filter:

<link rel="stylesheet" href="{{ 'style.css' | assets }}">
<script src="{{ 'main.js' | assets }}"></script>

• Load extra scripts when needed (order after their dependencies):

<script src="{{ 'cart.js' | assets }}"></script>
<script src="{{ 'product.js' | assets }}"></script>

• Pass media paths to widgets via page JSON/settings:

{
  "video_src": "a608fda95ffd4e489765a194c7d84c14.HD-720p-2.1Mbps-31583796_v=0.mp4"
}

Tips

• Use clear file names and prefer compressed formats (WebP) to reduce size.
• Keep dependency order in mind (e.g., swiper-init.js after loading Swiper).