Overview

Purpose

This page is an overview/README for the JavaScript assets folder: Assets/js/.

Assets/js/ contains:

The theme’s main boot file (theme.js).

Vendor libraries shipped with the theme (typically minified).

It is the primary place where the theme’s global client-side behavior is loaded.

theme.js

The theme boot file.

Detailed documentation: NoirDocs/4. Assets/JavaScript/theme.js.md.

Examples in this theme include Swiper, Leaflet (and marker cluster), Lightgallery, Nouislider, Axios, Alpine.

Guidelines:

Treat vendor/minified files as read-only.

Prefer wrapping/extending behavior in theme.js or component/reusable JS rather than modifying vendor sources.

Component-specific behavior: Components/<Name>/Default.js

Reusable-specific behavior: Reusables/<Name>/Default.js

Theme-wide behavior and cross-cutting utilities: Assets/js/theme.js

If the requirement is store-specific custom JavaScript (without changing the theme code), it can be added from the admin area:

Content → Customization → Layout → JS tab