Cursor rule

1---
2description: Localization coding standards and best practices guide
3globs: *.liquid,schemas/*
4alwaysApply: false
5---
6# Localization Standards
7 
8## Translation Requirements
9 
10- **Every user-facing text** must use translation filters
11- **Update `locales/en.default.json`** with all new keys
12- **Use descriptive, hierarchical keys** for organization
13- **Only add English text** - translators handle other languages
14 
15## Translation Filter Usage
16 
17**Use `{{ 'key' | t }}` for all text:**
18 
19```liquid
20<!-- Good -->
21<h2>{{ 'sections.featured_collection.title' | t }}</h2>
22<p>{{ 'sections.featured_collection.description' | t }}</p>
23<button>{{ 'products.add_to_cart' | t }}</button>
24 
25<!-- Bad -->
26<h2>Featured Collection</h2>
27<p>Check out our best products</p>
28<button>Add to cart</button>
29```
30 
31## Translation with Variables
32 
33**Use variables for interpolation:**
34 
35```liquid
36<!-- Liquid template -->
37<p>{{ 'products.price_range' | t: min: product.price_min | money, max: product.price_max | money }}</p>
38<p>{{ 'general.pagination.page' | t: page: paginate.current_page, pages: paginate.pages }}</p>
39```
40 
41**Corresponding keys in Locale files:**
42 
43```json
44{
45  "products": {
46    "price_range": "From {{ min }} to {{ max }}"
47  },
48  "general": {
49    "pagination": {
50      "page": "Page {{ page }} of {{ pages }}"
51    }
52  }
53}
54```
55 
56## Best Practices
57 
58**Content Guidelines:**
59- Write clear, concise text
60- Use sentence case for UI elements
61- Be consistent with terminology
62- Consider character limits for UI elements
63 
64**Variable Usage:**
65- Use interpolation rather than appending strings together
66- Naming should be prioritize clarity over brevity
67- Escape variables whenever they aren't expected to output HTML: `{{ variable | escape }}`
68