@getvitops/create 0.5.0 → 0.7.0

package/templates/emdash/site.json

@@ -0,0 +1,228 @@
+{
+  "$schema": "./node_modules/@getvitops/generator/config.schema.json",
+  "designSystem": {
+    "themes": {
+      "default": {
+        "$schema": "./node_modules/@getvitops/generator/schema.json",
+        "colors": {
+          "palette": {
+            "brand": {
+              "seed": "#2e9b73"
+            },
+            "ink": {
+              "seed": "#3f4a5c"
+            },
+            "sky": {
+              "seed": "#2f7bc0"
+            },
+            "sun": {
+              "seed": "#d08a1f"
+            },
+            "rose": {
+              "seed": "#c74a42"
+            }
+          },
+          "roles": {
+            "neutral": "ink",
+            "surface": "ink",
+            "ui-primary": "brand",
+            "brand-primary": "brand",
+            "info": "sky",
+            "success": "brand",
+            "warning": "sun",
+            "danger": "rose"
+          },
+          "utilities": ["bg", "text", "icon", "border"]
+        },
+        "shadows": {
+          "sm": "0 1px 2px rgb(0 0 0 / 0.08)",
+          "md": "0 4px 6px rgb(0 0 0 / 0.12)",
+          "lg": "0 10px 15px rgb(0 0 0 / 0.18)"
+        },
+        "fonts": {
+          "display": "system-ui, -apple-system, \"Segoe UI\", sans-serif",
+          "sans": "system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif",
+          "mono": "ui-monospace, \"SF Mono\", Menlo, monospace"
+        },
+        "typeScale": {
+          "base": "1rem",
+          "names": ["2xs", "xs", "s", "m", "l", "xl", "2xl", "3xl"],
+          "baseStep": 4,
+          "baseline": "m",
+          "ratio": 1.2,
+          "fluid": {
+            "minVw": "22.5rem",
+            "maxVw": "80rem",
+            "minRatio": 1.12
+          }
+        },
+        "spaceScale": {
+          "base": "1rem",
+          "names": ["2xs", "xs", "s", "m", "l", "xl", "2xl", "3xl"],
+          "baseStep": 4,
+          "baseline": "m",
+          "ratio": 1.25,
+          "fluid": {
+            "minVw": "22.5rem",
+            "maxVw": "80rem",
+            "minRatio": 1.2
+          }
+        },
+        "patterns": {
+          "defaults": {
+            "ds": "none",
+            "b": "1px solid var(--color-bg-surface-x-muted)",
+            "br": "0.375rem",
+            "p": "1rem",
+            "fs": "1rem"
+          },
+          "radii": {
+            "circle": "50%"
+          },
+          "groups": {
+            "control": {
+              "ds": "var(--ds-default)",
+              "b": "var(--b-default)",
+              "br": "var(--br-default)",
+              "p": "0.5em 1em",
+              "fs": "var(--fs-default)"
+            },
+            "panel": {
+              "ds": "var(--shadow-md)",
+              "b": "var(--b-default)",
+              "br": "0.5rem",
+              "p": "1rem",
+              "fs": "var(--fs-default)"
+            }
+          },
+          "z": {
+            "raised": 1,
+            "sticky": 100,
+            "overlay": 200,
+            "top": 1000
+          },
+          "items": {
+            "button": {
+              "group": "control",
+              "element": "button",
+              "default_role": "brand-primary",
+              "base": {
+                "padding": "0.6em 1.2em",
+                "border-radius": "var(--br-control, 0.25rem)",
+                "border": "none",
+                "font-weight": "600",
+                "color": "#fff",
+                "cursor": "pointer",
+                "box-shadow": "var(--shadow-sm)"
+              },
+              "states": {
+                "hover": {
+                  "step": 1
+                },
+                "active": {
+                  "scale": 0.97
+                },
+                "focus-visible": {
+                  "ring": true
+                }
+              },
+              "roles": []
+            },
+            "card": {
+              "group": "panel",
+              "class": "card",
+              "base": {
+                "border-radius": "var(--br-card-group)",
+                "padding": "1.5rem",
+                "background": "var(--color-bg-surface-muted)",
+                "border": "var(--b-card-group)",
+                "box-shadow": "var(--ds-card-group)"
+              },
+              "states": {},
+              "roles": []
+            }
+          }
+        },
+        "typography": {
+          "families": {
+            "display": "var(--font-display)",
+            "sans": "var(--font-sans)",
+            "code": "var(--font-mono, ui-monospace, monospace)"
+          },
+          "roles": {
+            "display": {
+              "family": "display",
+              "size": "var(--text-3xl)",
+              "weight": 700,
+              "line-height": "1.05",
+              "tracking": "-0.03em"
+            },
+            "heading": {
+              "family": "display",
+              "size": "var(--text-xl)",
+              "weight": 600,
+              "line-height": "1.3"
+            },
+            "body": {
+              "family": "sans",
+              "size": "var(--text-m)",
+              "weight": 400,
+              "line-height": "1.55"
+            }
+          },
+          "headings": {
+            "h1": "display",
+            "h2": "heading",
+            "h3": "heading"
+          }
+        },
+        "animations": {
+          "effects": {
+            "fade-in": {
+              "kf": "composite",
+              "vars": {
+                "opacity-from": 0
+              }
+            },
+            "slide-up": {
+              "kf": "composite",
+              "vars": {
+                "translate-y-from": "var(--slide-distance, 2rem)"
+              }
+            }
+          },
+          "journeys": {
+            "base": {
+              "fade": {
+                "opacity-from": 0
+              },
+              "slide": {}
+            },
+            "compose": [["fade"], ["slide"], ["fade", "slide"]]
+          }
+        }
+      }
+    },
+    "defaultColorScheme": "light"
+  },
+  "organization": {
+    "name": "My EmDash Site"
+  },
+  "site": {
+    "defaultLocale": "en",
+    "locales": {
+      "en": {
+        "name": "English"
+      }
+    },
+    "environments": {
+      "production": {
+        "url": "https://my-emdash-site.example.com"
+      },
+      "dev": {
+        "url": "https://dev.my-emdash-site.example.com",
+        "robots": "noindex,nofollow"
+      }
+    }
+  }
+}

package/templates/emdash/src/assets/placeholder/wireframe-400x400.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="400" height="400" viewBox="0 0 400 400"><rect width="100%" height="100%" fill="#DDDDDD"/><path fill="#999999" d="M87.3 204.72h11.66v-12.54q0-1.77.24-3.92zm17.36 0h4.82v3.79q0 .53-.35.91-.34.39-.98.39h-3.49v9.35h-5.7v-9.35H82.79q-.66 0-1.16-.42-.51-.41-.64-1.02l-.69-3.31 18.16-24.25h6.2zm35.59-4.72q0 5.01-1.08 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.47 3.59-2.59 1.18-5.58 1.18-3 0-5.55-1.18-2.56-1.17-4.44-3.59-1.88-2.41-2.94-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.94-6.09t4.44-3.59q2.55-1.18 5.55-1.18 2.99 0 5.58 1.18 2.58 1.18 4.47 3.59 1.9 2.41 2.97 6.09 1.08 3.69 1.08 8.72m-6.76 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1 1.62-1.6 4.35t-.6 6.89.6 6.89 1.6 4.35q1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89m37.5 0q0 5.01-1.08 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.47 3.59-2.59 1.18-5.58 1.18-3 0-5.55-1.18-2.56-1.17-4.44-3.59-1.88-2.41-2.94-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.94-6.09t4.44-3.59q2.55-1.18 5.55-1.18 2.99 0 5.58 1.18 2.58 1.18 4.47 3.59 1.9 2.41 2.97 6.09 1.08 3.69 1.08 8.72m-6.76 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1 1.62-1.6 4.35t-.6 6.89.6 6.89 1.6 4.35q1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89m48.84 10.39-3.47 3.42-8.99-8.99-9.06 9.04-3.47-3.42 9.06-9.09-8.64-8.64 3.45-3.44 8.64 8.64 8.58-8.59 3.5 3.45-8.61 8.61zm22.95-5.67h11.66v-12.54q0-1.77.24-3.92zm17.35 0h4.83v3.79q0 .53-.35.91-.34.39-.98.39h-3.5v9.35h-5.69v-9.35h-16.17q-.66 0-1.16-.42-.51-.41-.64-1.02l-.69-3.31 18.15-24.25h6.2zm35.59-4.72q0 5.01-1.07 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.48 3.59-2.58 1.18-5.57 1.18-3 0-5.56-1.18-2.55-1.17-4.43-3.59-1.89-2.41-2.95-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.95-6.09 1.88-2.41 4.43-3.59 2.56-1.18 5.56-1.18 2.99 0 5.57 1.18 2.59 1.18 4.48 3.59 1.9 2.41 2.97 6.09 1.07 3.69 1.07 8.72m-6.75 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1.01 1.62-1.6 4.35-.6 2.73-.6 6.89t.6 6.89q.59 2.73 1.6 4.35 1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89m37.49 0q0 5.01-1.07 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.48 3.59-2.58 1.18-5.57 1.18-3 0-5.56-1.18-2.55-1.17-4.43-3.59-1.89-2.41-2.95-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.95-6.09 1.88-2.41 4.43-3.59 2.56-1.18 5.56-1.18 2.99 0 5.57 1.18 2.59 1.18 4.48 3.59 1.9 2.41 2.97 6.09 1.07 3.69 1.07 8.72m-6.75 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1.01 1.62-1.6 4.35-.6 2.73-.6 6.89t.6 6.89q.59 2.73 1.6 4.35 1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89"/></svg>

package/templates/emdash/src/assets/placeholder/wireframe-400x600.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="400" height="600" viewBox="0 0 400 600"><rect width="100%" height="100%" fill="#DDDDDD"/><path fill="#999999" d="M87.3 304.72h11.66v-12.54q0-1.77.24-3.92zm17.36 0h4.82v3.79q0 .53-.35.91-.34.39-.98.39h-3.49v9.35h-5.7v-9.35H82.79q-.66 0-1.16-.42-.51-.41-.64-1.02l-.69-3.31 18.16-24.25h6.2zm35.59-4.72q0 5.01-1.08 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.47 3.59-2.59 1.18-5.58 1.18-3 0-5.55-1.18-2.56-1.17-4.44-3.59-1.88-2.41-2.94-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.94-6.09t4.44-3.59q2.55-1.18 5.55-1.18 2.99 0 5.58 1.18 2.58 1.18 4.47 3.59 1.9 2.41 2.97 6.09 1.08 3.69 1.08 8.72m-6.76 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1 1.62-1.6 4.35t-.6 6.89.6 6.89 1.6 4.35q1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89m37.5 0q0 5.01-1.08 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.47 3.59-2.59 1.18-5.58 1.18-3 0-5.55-1.18-2.56-1.17-4.44-3.59-1.88-2.41-2.94-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.94-6.09t4.44-3.59q2.55-1.18 5.55-1.18 2.99 0 5.58 1.18 2.58 1.18 4.47 3.59 1.9 2.41 2.97 6.09 1.08 3.69 1.08 8.72m-6.76 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1 1.62-1.6 4.35t-.6 6.89.6 6.89 1.6 4.35q1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89m48.84 10.39-3.47 3.42-8.99-8.99-9.06 9.04-3.47-3.42 9.06-9.09-8.64-8.64 3.45-3.44 8.64 8.64 8.58-8.59 3.5 3.45-8.61 8.61zm40.94-29.55-11.37 13.91-1.32 1.65q1.11-.56 2.4-.86 1.28-.31 2.76-.31 2.18 0 4.23.72 2.05.71 3.62 2.16 1.56 1.44 2.52 3.59.95 2.14.95 5 0 2.68-.98 5.03-.98 2.34-2.76 4.09-1.77 1.75-4.28 2.76-2.5 1-5.52 1-3.08 0-5.51-.98-2.44-.98-4.16-2.74-1.73-1.76-2.64-4.24-.92-2.48-.92-5.5 0-2.7 1.1-5.55t3.41-5.92l9.14-12.27q.48-.64 1.39-1.09.92-.45 2.11-.45zm-9.88 33.39q1.56 0 2.87-.53t2.25-1.48q.94-.96 1.47-2.24.53-1.29.53-2.8 0-1.64-.5-2.95t-1.43-2.23q-.93-.91-2.23-1.39-1.29-.48-2.86-.48-1.56 0-2.83.53-1.28.53-2.18 1.47t-1.4 2.23-.5 2.77q0 1.59.43 2.9.44 1.31 1.3 2.24t2.13 1.44q1.28.52 2.95.52M288.96 300q0 5.01-1.07 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.48 3.59-2.58 1.18-5.57 1.18-3 0-5.56-1.18-2.55-1.17-4.43-3.59-1.89-2.41-2.95-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.95-6.09 1.88-2.41 4.43-3.59 2.56-1.18 5.56-1.18 2.99 0 5.57 1.18 2.59 1.18 4.48 3.59 1.9 2.41 2.97 6.09 1.07 3.69 1.07 8.72m-6.75 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1.01 1.62-1.6 4.35-.6 2.73-.6 6.89t.6 6.89q.59 2.73 1.6 4.35 1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89m37.49 0q0 5.01-1.07 8.71-1.07 3.69-2.97 6.1-1.89 2.42-4.48 3.59-2.58 1.18-5.57 1.18-3 0-5.56-1.18-2.55-1.17-4.43-3.59-1.89-2.41-2.95-6.1-1.06-3.7-1.06-8.71 0-5.03 1.06-8.72 1.06-3.68 2.95-6.09 1.88-2.41 4.43-3.59 2.56-1.18 5.56-1.18 2.99 0 5.57 1.18 2.59 1.18 4.48 3.59 1.9 2.41 2.97 6.09 1.07 3.69 1.07 8.72m-6.75 0q0-4.16-.61-6.89t-1.63-4.35q-1.02-1.61-2.35-2.26-1.32-.65-2.75-.65-1.41 0-2.72.65t-2.32 2.26q-1.01 1.62-1.6 4.35-.6 2.73-.6 6.89t.6 6.89q.59 2.73 1.6 4.35 1.01 1.61 2.32 2.26t2.72.65q1.43 0 2.75-.65 1.33-.65 2.35-2.26 1.02-1.62 1.63-4.35t.61-6.89"/></svg>

package/templates/emdash/src/assets/placeholder/wireframe-600x400.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="600" height="400" viewBox="0 0 600 400"><rect width="100%" height="100%" fill="#DDDDDD"/><path fill="#999999" d="m155.52 171.08-17.16 21-2 2.48q1.68-.84 3.62-1.3t4.18-.46q3.28 0 6.38 1.08t5.46 3.26 3.8 5.42 1.44 7.56q0 4.04-1.48 7.58t-4.16 6.18-6.46 4.16-8.34 1.52q-4.64 0-8.32-1.48t-6.28-4.14-3.98-6.4-1.38-8.3q0-4.08 1.66-8.38t5.14-8.94l13.8-18.52q.72-.96 2.1-1.64t3.18-.68zm-14.92 50.4q2.36 0 4.34-.8t3.4-2.24 2.22-3.38.8-4.22q0-2.48-.76-4.46t-2.16-3.36-3.36-2.1-4.32-.72-4.28.8-3.28 2.22-2.12 3.36-.76 4.18q0 2.4.66 4.38t1.96 3.38 3.22 2.18 4.44.78M208.28 200q0 7.56-1.62 13.14t-4.48 9.22-6.76 5.42-8.42 1.78-8.38-1.78-6.7-5.42-4.44-9.22-1.6-13.14q0-7.6 1.6-13.16t4.44-9.2 6.7-5.42 8.38-1.78 8.42 1.78 6.76 5.42 4.48 9.2 1.62 13.16m-10.2 0q0-6.28-.92-10.4t-2.46-6.56-3.54-3.42-4.16-.98q-2.12 0-4.1.98t-3.5 3.42-2.42 6.56-.9 10.4.9 10.4 2.42 6.56 3.5 3.42 4.1.98q2.16 0 4.16-.98t3.54-3.42 2.46-6.56.92-10.4m56.6 0q0 7.56-1.62 13.14t-4.48 9.22-6.76 5.42-8.42 1.78-8.38-1.78-6.7-5.42-4.44-9.22-1.6-13.14q0-7.6 1.6-13.16t4.44-9.2 6.7-5.42 8.38-1.78 8.42 1.78 6.76 5.42 4.48 9.2 1.62 13.16m-10.2 0q0-6.28-.92-10.4t-2.46-6.56-3.54-3.42-4.16-.98q-2.12 0-4.1.98t-3.5 3.42-2.42 6.56-.9 10.4.9 10.4 2.42 6.56 3.5 3.42 4.1.98q2.16 0 4.16-.98t3.54-3.42 2.46-6.56.92-10.4m73.72 15.68-5.24 5.16-13.56-13.56-13.68 13.64-5.24-5.16 13.68-13.72L281.12 189l5.2-5.2 13.04 13.04 12.96-12.96 5.28 5.2-13 13zm34.64-8.56h17.6V188.2q0-2.68.36-5.92zm26.2 0h7.28v5.72q0 .8-.52 1.38t-1.48.58h-5.28v14.12h-8.6V214.8h-24.4q-1 0-1.76-.62t-.96-1.54l-1.04-5 27.4-36.6h9.36zm53.72-7.12q0 7.56-1.62 13.14t-4.48 9.22-6.76 5.42-8.42 1.78-8.38-1.78-6.7-5.42-4.44-9.22-1.6-13.14q0-7.6 1.6-13.16t4.44-9.2 6.7-5.42 8.38-1.78 8.42 1.78 6.76 5.42 4.48 9.2 1.62 13.16m-10.2 0q0-6.28-.92-10.4t-2.46-6.56-3.54-3.42-4.16-.98q-2.12 0-4.1.98t-3.5 3.42-2.42 6.56-.9 10.4.9 10.4 2.42 6.56 3.5 3.42 4.1.98q2.16 0 4.16-.98t3.54-3.42 2.46-6.56.92-10.4m56.6 0q0 7.56-1.62 13.14t-4.48 9.22-6.76 5.42-8.42 1.78-8.38-1.78-6.7-5.42-4.44-9.22-1.6-13.14q0-7.6 1.6-13.16t4.44-9.2 6.7-5.42 8.38-1.78 8.42 1.78 6.76 5.42 4.48 9.2 1.62 13.16m-10.2 0q0-6.28-.92-10.4t-2.46-6.56-3.54-3.42-4.16-.98q-2.12 0-4.1.98t-3.5 3.42-2.42 6.56-.9 10.4.9 10.4 2.42 6.56 3.5 3.42 4.1.98q2.16 0 4.16-.98t3.54-3.42 2.46-6.56.92-10.4"/></svg>

package/templates/emdash/vite.config.ts

@@ -8,7 +8,7 @@ export default defineConfig({
     // `subgrid` is the drift this catches, and it is only ever cheap to fix at the
     // moment it is written. `vitops lint` takes the staged paths as positionals.
     'src/**/*.{astro,html,ts,tsx,jsx,vue,svelte,css}':
-      'vitops lint -i design-system.json -f tailwind --strict',
+      'vitops lint -i site.json -f tailwind --strict',
   },
   fmt: {
     ignorePatterns: ['dist/**', 'node_modules/**', 'src/styles/**', 'public/vitops/**'],

package/templates/emdash/wrangler.jsonc

@@ -4,11 +4,16 @@
   "main": "./src/worker.ts",
   "compatibility_date": "2026-02-24",
   "compatibility_flags": ["nodejs_compat"],
+  // Explicit rather than relying on wrangler's default: this is the fact that
+  // lets a first deploy go live at <name>.<account>.workers.dev without
+  // touching any existing site's DNS — see SETUP.html's "Domain strategy"
+  // stage and site.json's environments.production.url.
   "workers_dev": true,
   // Custom domain: uncomment and set your apex. Cloudflare provisions the DNS
-  // record + TLS cert on deploy (the zone must already exist in the account).
-  // The dev deploy (scripts/build-dev-wrangler.mjs) automatically serves the
-  // dev worker from dev.<domain> when this is set.
+  // record + TLS cert on deploy (the zone must already exist in the account) —
+  // and OVERWRITES it, the moment an existing live site at that domain goes
+  // dark. The dev deploy (scripts/build-dev-wrangler.mjs) automatically serves
+  // the dev worker from dev.<domain> when this is set.
   // "routes": [{ "pattern": "example.com", "custom_domain": true }],
   // No database_id / bucket ids needed up front: wrangler provisions the D1
   // database and R2 bucket on the first `pnpm deploy` if they don't exist.

package/templates/static/.agents/skills/setup/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: setup
+description: Work the client-onboarding checklist (SETUP.html) autonomously — GitHub repo + branch policy, hosting resources, Search Console/GCP/ads connections. Use when the user asks to set up, onboard, or provision this project (e.g. "run setup", "onboard this site", "get this ready to deploy"). Never run this as a side effect of unrelated work, and never on your own initiative without the user asking.
+---
+
+# Setup (client onboarding)
+
+`SETUP.html` is the canonical checklist — this skill adds only sequencing,
+gates, and where to stop. It does not restate the steps; read `SETUP.html`
+(or `npx vitops setup --help`) for what each stage actually does and why.
+
+## Steps
+
+1. **Preview the whole sequence first.**
+
+   ```bash
+   npx vitops setup all --dry
+   ```
+
+   Read the plan before doing anything. It names every step it would take and
+   why any step is blocked — a missing credential, a field not yet in
+   `site.json`, GitHub Pro/Team gating branch protection.
+
+2. **Run it.**
+
+   ```bash
+   npx vitops setup all
+   ```
+
+   Re-run `npx vitops setup --check` after each leg rather than retrying on
+   your own judgment — a step already done resolves to a no-op skip, so a
+   second run is safe, and `--check` tells you exactly what still needs doing
+   instead of you guessing from output.
+
+3. **Tick `SETUP.html` boxes only for what you actually completed.** Never
+   check a box for a step marked below as human-only, even if you did
+   everything up to it — the human still has to act.
+
+## Hard stops — ask the human, do not attempt
+
+- **The Cloudflare API token.** No API can create one; there is no command to
+  run. Tell the user to create it at
+  <https://dash.cloudflare.com/profile/api-tokens> (Workers + D1 + R2 edit)
+  and run `gh secret set CLOUDFLARE_API_TOKEN`, then continue.
+- **The domain cutover** (`vitops setup domain`, stage 4b in `SETUP.html`).
+  Uncommenting the custom-domain route and deploying overwrites the zone's DNS
+  record at that instant — it takes an existing live site down. `setup domain`
+  only ever plans and checks this; it never applies it, and neither should
+  you. Report the plan and hand the actual cutover to the user.
+- **Publishing any generated legal document.** `vitops legal` renders a
+  starting point from the config, not a reviewed policy. Generate it, tell the
+  user it needs review, and stop — do not paste it into the admin or commit it
+  yourself.
+
+## If something is blocked
+
+`vitops setup --check` names the field or credential and where to get it —
+report that verbatim rather than guessing at a fix. A step reported as
+"blocked" is not a failure to retry; it is waiting on one of the hard stops
+above, or on a `site.json` field the user still needs to fill in (stage 5,
+Configuration).

package/templates/static/.env

@@ -0,0 +1 @@
+CLOUDFLARE_API_TOKEN=your_cloudflare_api_token

package/templates/static/.github/workflows/ci.yml

@@ -0,0 +1,12 @@
+# Runs on every PR: typecheck + design-lint + build. deploy-dev.yml /
+# deploy-prod.yml call the same reusable `site-ci.yml` themselves before they
+# deploy, so this is what gives a PR the identical signal before it's even
+# merged to `dev` — a broken build never reaches the dev worker.
+name: CI
+
+on:
+  pull_request:
+
+jobs:
+  ci:
+    uses: getvitops/design-system/.github/workflows/site-ci.yml@v1

package/templates/static/.github/workflows/deploy-dev.yml

@@ -0,0 +1,33 @@
+# Deploys the `dev` branch to the isolated dev worker (<name>-dev, and
+# dev.<domain> if a custom domain is configured in wrangler.jsonc).
+# `dev` is the integration branch — every push here refreshes the review site.
+# Promote to production with the "Promote dev → main" workflow (promote.yml).
+#
+# Deploys via the vitops toolchain's reusable static-site deploy workflow — see
+# https://github.com/getvitops/design-system/blob/main/.github/workflows/site-deploy-static.yml
+# Pinned to @v1 so a fix there reaches this repo without a manual re-paste;
+# bump the tag deliberately if you want to pick up a change.
+#
+# Required repo secrets:
+#   CLOUDFLARE_API_TOKEN   — token with Workers edit on this account
+#   CLOUDFLARE_ACCOUNT_ID  — the Cloudflare account id
+name: Deploy dev
+
+on:
+  push:
+    branches: [dev]
+
+concurrency:
+  group: deploy-dev
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    uses: getvitops/design-system/.github/workflows/site-deploy-static.yml@v1
+    with:
+      environment: dev
+      worker-name-suffix: -dev
+      route-prefix: dev.
+    secrets:
+      CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

package/templates/static/.github/workflows/deploy-prod.yml

@@ -0,0 +1,29 @@
+# Deploys `main` to production.
+# `main` should be branch-protected — it then only advances via the Promote
+# workflow (promote.yml), so a push here always represents promoted code. The
+# `production` GitHub Environment (set up by `scripts/init-github.mjs`) has
+# required reviewers restricted to admins, so this PAUSES for approval before
+# deploying.
+#
+# Deploys via the vitops toolchain's reusable static-site deploy workflow — see
+# https://github.com/getvitops/design-system/blob/main/.github/workflows/site-deploy-static.yml
+#
+# Required repo secrets: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID
+name: Deploy prod
+
+on:
+  push:
+    branches: [main]
+
+concurrency:
+  group: deploy-prod
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    uses: getvitops/design-system/.github/workflows/site-deploy-static.yml@v1
+    with:
+      environment: production
+    secrets:
+      CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

package/templates/static/.github/workflows/promote.yml

@@ -0,0 +1,16 @@
+# Promote dev → main. Run manually after reviewing the dev site.
+# Opens a PR from dev into the protected `main` branch and enables auto-merge;
+# the merge triggers Deploy prod.
+#
+# Deploys via the vitops toolchain's reusable promote workflow — see
+# https://github.com/getvitops/design-system/blob/main/.github/workflows/site-promote.yml
+# for the branch-protection / PROMOTE_TOKEN options.
+name: Promote dev → main
+
+on:
+  workflow_dispatch:
+
+jobs:
+  promote:
+    uses: getvitops/design-system/.github/workflows/site-promote.yml@v1
+    secrets: inherit

package/templates/static/.nvmrc

@@ -0,0 +1 @@
+24

package/templates/static/AGENTS.md

@@ -0,0 +1,64 @@
+This is a static Astro website styled by the Vitops design system, deployed
+as Cloudflare Workers static assets (no server runtime, no database).
+
+## Ground rules
+
+- `site.json` is the single source of truth — organization + site facts, and
+  the design system (colors, type, spacing, patterns, animations) under
+  `designSystem.themes.default`. Never edit `src/styles/` by hand — it is
+  generated from `site.json` by the `vitops()` integration on every dev/build
+  and is gitignored. (There is no separate `design-system.json`: a scaffolded
+  config can't merely reference a sibling file, so the token set lives inside
+  `site.json`.)
+- `src/assets/placeholder/` holds neutral wireframe stand-ins (square,
+  portrait, landscape; SVG + PNG) for layout work before real imagery
+  exists. Delete the directory once real assets land.
+- Prefer framework CSS classes (utilities, patterns, type roles like
+  `font-heading`) over bespoke CSS. Run `npx vitops agents` to append the
+  full generated class-vocabulary reference to this file.
+- **Layout foundations — these are the answer, not a starting point.** Six
+  substitutions carry the structure of nearly every page:
+  | About to write… | Write instead |
+  | --- | --- |
+  | a `wrap`/`wrapper`/`container`/`inner` class | **`centered`** |
+  | `max-width` + `margin-inline: auto` | **`centered`** |
+  | `padding-block` on a section | **`region`** |
+  | margins between headings/paragraphs/lists | **`rhythm`** |
+  | `display: grid` + `grid-template-columns: repeat(n, …)` | **`subgrid`** |
+  | `repeat(auto-fit, minmax(…))` | **`grid-auto`** |
+  | `display: flex` + `gap` for a row of controls | **`cluster`** |
+- Every page is prerendered by default (`output: 'static'`) — there is no
+  server to fall back to, so nothing here can read request-time data
+  (cookies, headers, query params) at render time. If a page genuinely needs
+  that, it needs an adapter and a different template — this one stays pure
+  static on purpose.
+- **`SETUP.html` is the client-onboarding checklist.** When working it via the
+  `.agents/skills/setup/` skill, tick a box only for a step you actually
+  completed — never on the operator's behalf for a step marked human-only
+  (the Cloudflare API token, the domain cutover, publishing legal documents).
+
+## Branch model
+
+- Work on **`dev`** (the integration branch). Every push auto-deploys the
+  isolated `-dev` worker (`dev.<domain>` with a custom domain).
+- **`main`** is production and branch-protected — never push or merge to it
+  directly. Production ships only via the manual **promote** flow:
+  `.github/workflows/promote.yml`, dispatched manually, opens a `dev → main`
+  PR with auto-merge; merging deploys prod. Only run it when the user
+  explicitly asks to promote/ship to production.
+
+## Commands
+
+- `pnpm dev` — local dev
+- `pnpm typecheck` — `astro check`
+- `pnpm run build:css` — regenerate the framework CSS from `site.json`
+- `pnpm deploy` — build + `wrangler deploy` to prod
+- `pnpm run deploy:dev` — build + deploy the isolated dev worker
+- `pnpm run init:github` — one-time: create + push the GitHub repo (main +
+  dev, dev default, branch protection + environment policy). Only run when
+  the user asks to set up GitHub.
+- `pnpm run init:hosting` — one-time: read the Cloudflare account id and set
+  it as a repo secret. Only run when the user asks for it.
+- `npx vitops validate site.json` — schema-check the site config
+- `npx vitops lint -i site.json -f css` — find framework classes in
+  source that resolve to nothing under this format

package/templates/static/README.md

@@ -0,0 +1,80 @@
+# My Static Site
+
+A static [Astro](https://astro.build) website on Cloudflare Workers (static
+assets — no server runtime), styled by the
+[Vitops design system](https://www.npmjs.com/org/getvitops).
+
+Scaffolded from `vp create @getvitops:static`.
+
+## Stack
+
+- **Astro** (`output: 'static'`) on **Cloudflare Workers Static Assets** — no
+  adapter, no database, no server runtime
+- **`@getvitops/astro`** — generates the design-system CSS from `site.json`
+  (design tokens live at `designSystem.themes.default`) and serves the
+  web-component runtime
+
+`src/assets/placeholder/` ships neutral wireframe images for layout work
+before real imagery exists — delete once real assets land.
+
+## Local development
+
+```bash
+pnpm install
+pnpm dev
+```
+
+- Site: <http://localhost:4321>
+
+## Deploy
+
+```bash
+npx wrangler login
+pnpm deploy
+```
+
+For a custom domain, uncomment the `routes` block in `wrangler.jsonc` and set
+your apex — Cloudflare provisions the DNS record + TLS cert on deploy.
+
+## Environments: dev → main promotion
+
+The repo ships a two-environment flow modeled on branch = environment:
+
+- **`dev`** is the integration branch. Every push auto-deploys the isolated
+  `-dev` worker (`.github/workflows/deploy-dev.yml`), served at
+  `dev.<domain>` when a custom domain is configured (or the worker's
+  `workers.dev` URL otherwise).
+- **`main`** is production. Every push auto-deploys the prod worker
+  (`.github/workflows/deploy-prod.yml`) — gated behind a `production`
+  GitHub Environment that requires an admin's approval before it runs.
+- **Promotion is manual**: run the **"Promote dev → main"** workflow
+  (`.github/workflows/promote.yml`) and it opens a PR from `dev` into `main`
+  with auto-merge enabled. With required reviews on `main`, a human approves
+  the PR; merging deploys prod (after the admin approval above).
+
+One-time setup — work through the checklist:
+
+```bash
+pnpm run sop && open SETUP.html   # or: xdg-open SETUP.html
+```
+
+It covers host choice, GitHub + branch policy, hosting resources, going live
+safely on `*.workers.dev` before any custom-domain cutover, configuration,
+Search Console/GCP/ads connections, legal documents, and launch gates — one
+command per step. An AI agent can work the same list autonomously via
+`.agents/skills/setup/`; it stops at the steps that genuinely need a human
+(the Cloudflare API token, the domain cutover, publishing legal documents).
+
+`pnpm run deploy:dev` reproduces the dev deploy locally: it writes a
+gitignored `.wrangler.dev.json` with the worker renamed and any custom-domain
+route prefixed `dev.` (`scripts/dev-wrangler-config.mjs`), so it never
+touches the prod worker.
+
+## CI/deploy workflows
+
+`.github/workflows/{ci,deploy-dev,deploy-prod,promote}.yml` are thin callers
+of reusable workflows published by
+[`getvitops/design-system`](https://github.com/getvitops/design-system),
+pinned to `@v1`. A fix to the shared deploy logic there reaches this repo the
+next time those workflows run — no re-pasting needed. Bump the pin
+deliberately if you want to hold back a change.