Add development standards documentation for theme components

AGENTS.md

@@ -0,0 +1,207 @@
+# Prompts and References
+
+Always Apply Rule: [Prompts and References](.cursor/rules/prompts-and-references.mdc)
+
+## CSS Standards
+
+Writing CSS, whether inside .css files or in the `{% stylesheet %}…{% endstylesheet %}` or `{% style %}…{% endstyle %}` tags
+
+Rules: [CSS Standards](.cursor/rules/css-standards.mdc)
+
+## JavaScript Standards
+
+Writing JavaScript inside `.js` files, or within the `{% javascript %}` or `{% script %}` tags in `.liquid` files.
+
+Rules: [JavaScript Standards](.cursor/rules/javascript-standards.mdc)
+
+## Liquid Syntax Standards
+
+Liquid syntax standards
+
+Liquid Rules: [Liquid Syntax Standards](.cursor/rules/liquid.mdc)
+
+## Localization Standards
+
+Localization coding standards and best practices guide
+
+Liquid Schemas Rules: [Localization Standards](.cursor/rules/localization.mdc)
+
+## Modern HTML Standards
+
+Liquid Rules: [Modern HTML Standards](.cursor/rules/html-standards.mdc)
+
+## Accessibility
+
+## Global Scope Accessibility Standards
+
+Global scope accessibility standards per WCAG requirements for page language, viewport, title attributes, and skip links
+
+Always apply Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Global Scope Accessibility](.cursor/rules/global-accessibility-standards.mdc)
+
+### Color Contrast Accessibility Standards
+
+Text and user interface color contrast compliance with WCAG 2.2 1.4.3 and 1.4.11
+
+Always apply CSS, SCSS, SASS, LESS, Vue, JSX, TSX, HTML, PHP, JS, and TS Rules: [Color Contrast Accessibility](.cursor/rules/color-contrast-accessibility.mdc)
+
+### Focus Order and Focus Styles Accessibility Standards
+
+Focus order and focus styles accessibility standards per WCAG 2.4.7 Focus Visible, 1.4.11 Non-Text Contrast, 2.4.13 Focus Appearance, and 2.4.11 Focus Not Obscured requirements
+
+Always apply Vue, JSX, TSX, HTML, PHP, JS, TS, Liquid, CSS, SCSS, SASS, and LESS Rules: [Focus Order and Focus Styles Accessibility](.cursor/rules/focus-order-and-styles-accessibility.mdc)
+
+### Form Accessibility Standards
+
+Form component accessibility standards and WCAG compliance for form inputs, labels, instructions, and error handling
+
+Always apply Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Form Accessibility](.cursor/rules/form-accessibility.mdc)
+
+### Heading Element Accessibility Standards
+
+Heading element accessibility compliance and WCAG 2.4.1 Bypass Blocks requirements
+
+Always apply Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Heading Accessibility](.cursor/rules/heading-accessibility.mdc)
+
+### Image Alt Text Accessibility Standards
+
+Image alternative text accessibility compliance and WCAG 2.2 requirements
+
+Always apply Vue, JSX, TSX, HTML, PHP, JS, TS, Liquid, CSS, SCSS, SASS, and LESS Rules: [Image Alt Text Accessibility](.cursor/rules/image-alt-text-accessibility.mdc)
+
+### Landmark Element Accessibility Standards
+
+Landmark element accessibility compliance and WCAG 2.4.1 Bypass Blocks requirements
+
+Always apply Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Landmark Accessibility](.cursor/rules/landmark-accessibility.mdc)
+
+### Table Element Accessibility Standards
+
+Table element accessibility compliance
+
+Always apply Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Table Accessibility](.cursor/rules/table-accessibility.mdc)
+
+### Animation Accessibility Standards
+
+Enforce animation accessibility standards per WCAG 2.2.2 Pause Stop Hide, 2.3.1 Three Flashes or Below Threshold, and 2.3.3 Animation from Interactions requirements
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, CSS, SCSS, SASS, and LESS Rules: [Animation Accessibility](.cursor/rules/animation-accessibility.mdc)
+
+### Breadcrumb Accessibility
+
+Breadcrumb component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Breadcrumb Accessibility](.cursor/rules/breadcrumb-accessibility.mdc)
+
+### Chat Window Component Accessibility Standards
+
+Chat window component accessibility compliance and WCAG compliance for real-time communication features
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Chat Window Accessibility](.cursor/rules/chat-window-accessibility.mdc)
+
+### Color Swatch Variant Selector Component Accessibility Standards
+
+Color swatch component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Color Swatch Accessibility](.cursor/rules/color-swatch-accessibility.mdc)
+
+### Combobox Component Accessibility Standards
+
+Combobox component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Combobox Accessibility](.cursor/rules/combobox-accessibility.mdc)
+
+### Disclosure Component Accessibility Standards
+
+Disclosure component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Disclosure Accessibility](.cursor/rules/disclosure-accessibility.mdc)
+
+### Dropdown Navigation Component Accessibility Standards
+
+Dropdown Navigation component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Dropdown Navigation Accessibility](.cursor/rules/dropdown-navigation-accessibility.mdc)
+
+### Flip Card Component Accessibility Standards
+
+Flip Card component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Flip Card Accessibility](.cursor/rules/flip-card-accessibility.mdc)
+
+### Mobile Accessibility Best Practices
+
+Mobile accessibility standards per WCAG 2.5.8 Target Size (Minimum), 2.4.1 Bypass Blocks, and 1.3.4 Orientation requirements
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, Liquid, CSS, SCSS, SASS, and LESS Rules: [Mobile Accessibility](.cursor/rules/mobile-accessibility-standards.mdc)
+
+### Modal Window Accessibility Standards
+
+Modal window accessibility compliance and ARIA Dialog Pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Modal Window Accessibility](.cursor/rules/modal-accessibility.mdc)
+
+### Product Filter Component Accessibility Standards
+
+Product filter component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Product Filter Accessibility](.cursor/rules/product-filter-accessibility.mdc)
+
+### Sale Price Component Accessibility Standards
+
+Sale price component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Sale Price Accessibility](.cursor/rules/sale-price-accessibility.mdc)
+
+### Slider Component Accessibility Standards
+
+Slider component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Slider Accessibility](.cursor/rules/slider-accessibility.mdc)
+
+### Switch Component Accessibility Standards
+
+Switch component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Switch Accessibility](.cursor/rules/switch-accessibility.mdc)
+
+### Tab Component Accessibility Standards
+
+Tab component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Tab Accessibility](.cursor/rules/tab-accessibility.mdc)
+
+### Tooltip Component Accessibility Standards
+
+Tooltip component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Tooltip Accessibility](.cursor/rules/tooltip-accessibility.mdc)
+
+### Accordion Component Accessibility Standards
+
+Accordion component accessibility compliance and WAI-ARIA Accordion Pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Accordion Accessibility](.cursor/rules/accordion-accessibility.mdc)
+
+### Carousel Accessibility Standards
+
+Carousel component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Carousel Accessibility](.cursor/rules/carousel-accessibility.mdc)
+
+### Cart Drawer Component Accessibility Standards
+
+Cart drawer component accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Cart Drawer Accessibility](.cursor/rules/cart-drawer-accessibility.mdc)
+
+### Product Card Component Accessibility Standards
+
+Product card accessibility compliance pattern
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Product Card Accessibility](.cursor/rules/product-card-accessibility.mdc)
+
+### Product Media Gallery Component Accessibility Standards
+
+Enforce product media gallery component accessibility standards and proper landmark structure for media galleries
+
+Vue, JSX, TSX, HTML, PHP, JS, TS, and Liquid Rules: [Product Media Gallery Accessibility](.cursor/rules/product-media-gallery-accessibility.mdc)

assets/AGENTS.md

@@ -0,0 +1,5 @@
+# Assets
+
+Static files (css, js, and images) for theme templates
+
+Rules: [Assets](../.cursor/rules/assets.mdc)

blocks/AGENTS.md

@@ -0,0 +1,9 @@
+# Theme Blocks Development Standards
+
+Development standards and best practices for creating/configuring/styling theme blocks, including static and nested blocks, schema configuration, CSS, and usage examples
+
+Liquid Rules: [Theme Blocks](../.cursor/rules/blocks.mdc)
+
+## Schema Standards
+
+Liquid Rules: [Schema Standards](../.cursor/rules/schemas.mdc)

config/AGENTS.md

@@ -0,0 +1,5 @@
+# Settings Schema Standards
+
+Guidelines and examples for organizing and structuring the Shopify theme settings schema.
+
+Settings Schema Rules: [Theme Settings](../.cursor/rules/theme-settings.mdc)

locales/AGENTS.md

@@ -0,0 +1,5 @@
+# Translation Development Standards
+
+Locales coding standards and best practices guide
+
+JSON Rules: [Locales](../.cursor/rules/locales.mdc)

schemas/AGENTS.md

@@ -0,0 +1,3 @@
+# Schema Standards
+
+Rules: [Schema Standards](../.cursor/rules/schemas.mdc)

sections/AGENTS.md

@@ -0,0 +1,9 @@
+# Section Development Standards
+
+Section coding standards and best practices guide
+
+Liquid Rules: [Section Development Standards](../.cursor/rules/sections.mdc)
+
+## Schema Standards
+
+Liquid Rules: [Schema Standards](../.cursor/rules/schemas.mdc)

snippets/AGENTS.md

@@ -0,0 +1,3 @@
+# Snippet Development Standards
+
+Liquid Rules: [Snippet Development Standards](../.cursor/rules/snippets.mdc)

templates/AGENTS.md

@@ -0,0 +1,3 @@
+# Templates
+
+JSON Rules: [Templates](../.cursor/rules/templates.mdc)