Performance Strategy

Storefront performance is a project-level priority.

Principles

• Avoid repeated storefront database reads.
• Cache aggregate theme configuration per store.
• Keep CSS and JavaScript lightweight.
• Prefer progressive enhancement.
• Avoid excessive DOM weight.
• Lazy-load images where appropriate.
• Defer non-critical JavaScript where it does not break behaviour.

Settings and Cache

Theme settings should be loaded once, merged with defaults, and cached as an aggregate. Cache invalidation should happen after section save, reset, or explicit cache clear.

Assets

Asset loading should remain simple until a build pipeline is justified. Critical CSS, deferred JavaScript, and image optimisation belong to later performance work.

Validation

Performance-related PRs should describe expected storefront impact and include measurement or browser validation where practical.