Cursor rule

1---
2description:
3globs: templates/*.json
4alwaysApply: false
5---
6# Templates
7 
8All JSON templates must follow this exact structure:
9 
10## Required Schema
11```json
12{
13  "$schema": "http://json-schema.org/draft-07/schema#",
14  "type": "object",
15  "required": ["sections"],
16  "properties": {
17    "sections": {
18      "type": "object",
19      "patternProperties": {
20        "^[a-zA-Z0-9_-]+$": {
21          "type": "object",
22          "required": ["type"],
23          "properties": {
24            "type": {
25              "type": "string",
26              "pattern": "^[a-zA-Z0-9_-]+$"
27            },
28            "settings": {
29              "type": "object"
30            },
31            "blocks": {
32              "type": "array",
33              "items": {
34                "type": "object",
35                "required": ["type"],
36                "properties": {
37                  "type": {
38                    "type": "string"
39                  },
40                  "settings": {
41                    "type": "object"
42                  }
43                }
44              }
45            }
46          }
47        }
48      }
49    },
50    "order": {
51      "type": "array",
52      "items": {
53        "type": "string"
54      }
55    }
56  }
57}
58```
59 
60## Template Structure Rules
61 
62- Every template must have a `sections` object
63- Section keys must be alphanumeric with dashes/underscores
64- Each section must have a `type` property
65- `settings` and `blocks` are optional
66- `order` array defines section sequence
67- Blocks must have a `type` property
68 
69 
70## Template Types
71 
72**Standard Templates:**
73- `index.json` - Homepage
74- `product.json` - Product pages
75- `collection.json` - Collection pages
76- `page.json` - Static pages
77- `blog.json` - Blog listing
78- `article.json` - Blog posts
79- `cart.json` - Shopping cart
80- `search.json` - Search results
81 
82**Alternate Templates:**
83Alternative templates may exist for any of the standard templates, following the structure `template-name.template-suffix.template-file-type`, for example: `product.alternate.json`
84 
85## Valid Template Examples
86 
87**Product Template:**
88```json
89{
90  "sections": {
91    "header": {
92      "type": "header"
93    },
94    "main": {
95      "type": "main-product",
96      "settings": {
97        "show_vendor": true,
98        "show_sku": false,
99        "media_size": "medium"
100      },
101      "blocks": {
102        "title": {
103          "type": "title",
104          "settings": {}
105        },
106        "price": {
107          "type": "price",
108          "settings": {
109            "show_compare_at": true
110          }
111        },
112        "variant_picker": {
113          "type": "variant_picker",
114          "settings": {
115            "picker_type": "dropdown"
116          }
117        }
118      },
119      "block_order": ["title", "price", "variant_picker"]
120    },
121    "footer": {
122      "type": "footer"
123    }
124  },
125  "order": ["header", "main", "footer"]
126}
127```
128 
129**Collection Template:**
130```json
131{
132  "sections": {
133    "header": {
134      "type": "header"
135    },
136    "collection-banner": {
137      "type": "collection-banner",
138      "settings": {
139        "show_collection_description": true,
140        "show_collection_image": false
141      }
142    },
143    "main": {
144      "type": "main-collection-product-grid",
145      "settings": {
146        "products_per_page": 24,
147        "columns_desktop": 4,
148        "columns_mobile": 2
149      }
150    }
151  },
152  "order": ["header", "collection-banner", "main"]
153}
154```
155