Cursor rule

1---
2description: Static files (css, js, and images) for theme templates
3globs: assets/*
4alwaysApply: false
5---
6# Assets
7 
8The assets directory contains any assets that need to be referenced within a `.liquid` file, usually using the [asset_url](mdc:https:/shopify.dev/docs/api/liquid/filters/asset_url) Liquid filter.
9 
10Assets is a flat directory, it may not contain subdirectories.
11 
12Any images that are required in the code, including icons, may be stored within assets.  Icons can be used in `.liquid` files via the [inline_asset_content](mdc:https:/shopify.dev/docs/api/liquid/filters/inline_asset_content) Liquid filter.
13 
14## SVG Icon Accessibility
15 
16All SVG icon files in assets must include `aria-hidden="true"` on the root `<svg>` element:
17 
18```svg
19<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="none">
20  <!-- paths -->
21</svg>
22```
23 
24This ensures decorative icons are hidden from screen readers. The accessible name should be provided by the interactive element (button, link) that contains the icon, not by the icon itself.
25