@anvpx/motion-templates 0.0.0-stage → 0.1.0

package/templates/update/blueprints/release-notes.json

@@ -0,0 +1,151 @@
+{
+  "id": "release-notes",
+  "purpose": "Present a release: product and version, 3-6 icon highlights, an optional screenshot, and one thing to try.",
+  "discover": {
+    "useCases": [
+      "Summarise a release in under a minute: headline changes, one screenshot and what to try.",
+      "Show three to six new capabilities as icon cards for users who skim.",
+      "Announce a new version of a tool, service or library to its audience."
+    ],
+    "audience": ["users", "customers", "teammates"],
+    "goodFor": "A release with 3-6 headline changes and an optional screenshot.",
+    "notFor": "Many dated versions (changelog), launch persuasion (pitch), tutorials (guide).",
+    "tags": ["update", "release-notes", "product", "launch", "announce"],
+    "tone": ["calm", "direct"],
+    "aspects": ["16:9", "1:1"],
+    "lengths": {
+      "min": 20,
+      "max": 50
+    }
+  },
+  "slots": {
+    "product": {
+      "type": "text",
+      "max": 40,
+      "required": true
+    },
+    "version": {
+      "type": "text",
+      "max": 20,
+      "required": true
+    },
+    "highlights": {
+      "type": "object",
+      "fields": {
+        "icon": "text",
+        "label": "text",
+        "detail": "text"
+      },
+      "list": true,
+      "min": 3,
+      "max": 6,
+      "required": true
+    },
+    "screenshot": {
+      "type": "text",
+      "max": 120,
+      "optional": true
+    },
+    "caption": {
+      "type": "text",
+      "max": 100,
+      "optional": true
+    },
+    "try": {
+      "type": "text",
+      "max": 60,
+      "default": "Update today and try it"
+    },
+    "length": {
+      "type": "enum",
+      "values": ["short", "standard", "long"],
+      "default": "standard"
+    },
+    "style": {
+      "type": "enum",
+      "values": ["tidy", "punchy", "techdark"],
+      "default": "tidy"
+    }
+  },
+  "example": {
+    "product": "Briar Notes",
+    "version": "Version 2.4",
+    "highlights": [
+      {
+        "icon": "zap",
+        "label": "Faster startup",
+        "detail": "Half the time"
+      },
+      {
+        "icon": "shield-check",
+        "label": "Safer sign-in",
+        "detail": "Two-step checks"
+      },
+      {
+        "icon": "palette",
+        "label": "Custom themes",
+        "detail": "Light or dark"
+      },
+      {
+        "icon": "download",
+        "label": "Offline mode",
+        "detail": "Work anywhere"
+      }
+    ],
+    "try": "Update today and try it"
+  },
+  "meta": {
+    "title": {
+      "$slot": "product"
+    },
+    "lang": "en"
+  },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": {
+        "kicker": "Release notes",
+        "title": {
+          "$slot": "product"
+        },
+        "subtitle": {
+          "$slot": "version"
+        }
+      }
+    },
+    {
+      "id": "highlights",
+      "type": "icon-grid",
+      "props": {
+        "title": "What is new",
+        "items": {
+          "$slot": "highlights"
+        }
+      }
+    },
+    {
+      "when": "screenshot",
+      "id": "screen",
+      "type": "media-frame",
+      "props": {
+        "image": {
+          "$slot": "screenshot"
+        },
+        "device": "browser",
+        "caption": {
+          "$slot": "caption"
+        }
+      }
+    },
+    {
+      "id": "end",
+      "type": "outro",
+      "props": {
+        "title": {
+          "$slot": "try"
+        }
+      }
+    }
+  ]
+}

package/templates/update/blueprints/weekly-update.json

@@ -0,0 +1,88 @@
+{
+  "id": "weekly-update",
+  "purpose": "Give a team's period summary: what is done, key numbers, what is next and what is blocked.",
+  "discover": {
+    "useCases": [
+      "Give a team its period progress, upcoming work and blockers in under a minute.",
+      "Share two or three headline numbers with a short list of finished work.",
+      "Flag what is blocked and what help is needed."
+    ],
+    "audience": ["teammates", "stakeholders", "managers"],
+    "goodFor": "A recurring progress update with 2-5 done items and a few next steps.",
+    "notFor": "Deep KPI analysis (report), a single announcement (announcement).",
+    "tags": ["update", "status", "internal", "recap", "kpi"],
+    "tone": ["calm", "direct"],
+    "aspects": ["16:9", "1:1"],
+    "lengths": { "min": 25, "max": 60 }
+  },
+  "slots": {
+    "team": { "type": "text", "max": 40, "required": true },
+    "period": { "type": "text", "max": 30, "required": true },
+    "done": { "type": "text[]", "min": 2, "max": 5, "itemMax": 50, "required": true },
+    "kpis": {
+      "type": "object",
+      "fields": { "value": "text", "label": "text", "delta": "text" },
+      "list": true,
+      "min": 2,
+      "max": 3,
+      "optional": true
+    },
+    "next": { "type": "text[]", "min": 1, "max": 4, "itemMax": 50, "required": true },
+    "blockers": { "type": "text[]", "min": 1, "max": 3, "itemMax": 60, "optional": true },
+    "closing": { "type": "text", "max": 60, "default": "Questions in the team channel" },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["tidy", "punchy", "techdark"], "default": "tidy" }
+  },
+  "example": {
+    "team": "Platform Team",
+    "period": "Week of Oct 21",
+    "done": [
+      "Shipped the new onboarding flow",
+      "Closed 12 support requests",
+      "Moved reports to the new database"
+    ],
+    "kpis": [
+      { "value": "98.9", "label": "Uptime %", "delta": "+0.4" },
+      { "value": "12", "label": "Requests closed", "delta": "+3" },
+      { "value": "4.2", "label": "Days to review", "delta": "-0.8" }
+    ],
+    "next": ["Start the mobile redesign", "Run a load test", "Plan next quarter"],
+    "blockers": ["Waiting on legal sign-off", "Test environment is down"],
+    "closing": "Questions in the team channel"
+  },
+  "meta": { "title": { "$slot": "team" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": {
+        "kicker": "Weekly update",
+        "title": { "$slot": "team" },
+        "subtitle": { "$slot": "period" }
+      }
+    },
+    {
+      "id": "done",
+      "type": "bullets",
+      "props": { "title": "Done", "items": { "$slot": "done" }, "marker": "check" }
+    },
+    {
+      "when": "kpis",
+      "id": "numbers",
+      "type": "kpi-grid",
+      "props": { "title": "By the numbers", "items": { "$slot": "kpis" } }
+    },
+    {
+      "id": "next",
+      "type": "bullets",
+      "props": { "title": "Next", "items": { "$slot": "next" }, "marker": "number" }
+    },
+    {
+      "when": "blockers",
+      "id": "blocked",
+      "type": "bullets",
+      "props": { "title": "Blocked", "items": { "$slot": "blockers" }, "marker": "cross" }
+    },
+    { "id": "end", "type": "outro", "props": { "title": { "$slot": "closing" } } }
+  ]
+}

package/templates/update/copy.md

@@ -0,0 +1,17 @@
+# Update copy guide
+
+Tone: calm, direct, factual. Say what changed and why it matters. Do not hype.
+
+Do
+- Lead with the result: "Faster exports", not "We improved exports".
+- Labels: 2-4 words. Details: one short clause, no full stop.
+- Versions and dates exactly as written ("v2.4", "Oct 28"); one change per entry.
+- Weekly updates: done items in past tense, next items in future tense, blockers name the need.
+- Close with one action: what to try, read or ask.
+
+Don't
+- No exclamation marks, emoji or words like "amazing", "revolutionary", "seamless".
+- No more than 7 entries, 6 highlights or 14 code lines; split long lists.
+- No invented numbers; every figure comes from the brief.
+
+Vocabulary: "release" not "drop", "fix" not "remediation", "blocked" not "challenged".

package/templates/update/pacing.json

@@ -0,0 +1,64 @@
+{
+  "wordsPerSecond": 2.5,
+  "sceneSeconds": {
+    "title": {
+      "short": 3,
+      "standard": 4,
+      "long": 5
+    },
+    "icon-grid": {
+      "short": 6,
+      "standard": 9,
+      "long": 12
+    },
+    "media-frame": {
+      "short": 4,
+      "standard": 6,
+      "long": 8
+    },
+    "timeline": {
+      "short": 7,
+      "standard": 10,
+      "long": 14
+    },
+    "code": {
+      "short": 4,
+      "standard": 5,
+      "long": 8
+    },
+    "bullets": {
+      "short": 5,
+      "standard": 7,
+      "long": 10
+    },
+    "kpi-grid": {
+      "short": 5,
+      "standard": 6,
+      "long": 8
+    },
+    "callout": {
+      "short": 4,
+      "standard": 6,
+      "long": 8
+    },
+    "outro": {
+      "short": 3,
+      "standard": 4,
+      "long": 5
+    }
+  },
+  "lengths": {
+    "short": {
+      "scenes": [3, 5],
+      "totalSec": [10, 40]
+    },
+    "standard": {
+      "scenes": [3, 6],
+      "totalSec": [15, 60]
+    },
+    "long": {
+      "scenes": [4, 7],
+      "totalSec": [25, 80]
+    }
+  }
+}

package/templates/update/styles/punchy.json

@@ -0,0 +1,15 @@
+{
+  "id": "punchy",
+  "theme": "bold-light",
+  "frame": {
+    "width": 1920,
+    "height": 1080,
+    "fps": 30
+  },
+  "direction": {
+    "shot": "close",
+    "move": "push-in",
+    "ease": "spring-snappy",
+    "transition": "crossfade"
+  }
+}

package/templates/update/styles/techdark.json

@@ -0,0 +1,6 @@
+{
+  "id": "techdark",
+  "theme": "tech-dark",
+  "frame": { "width": 1920, "height": 1080, "fps": 30 },
+  "direction": { "shot": "close", "move": "static", "ease": "spring-snappy", "transition": "cut" }
+}

package/templates/update/styles/tidy.json

@@ -0,0 +1,6 @@
+{
+  "id": "tidy",
+  "theme": "calm-light",
+  "frame": { "width": 1920, "height": 1080, "fps": 30 },
+  "direction": { "shot": "medium", "move": "push-in", "ease": "out", "transition": "crossfade" }
+}

package/templates/update/template.json

@@ -0,0 +1,67 @@
+{
+  "templateVersion": 1,
+  "id": "update",
+  "version": "1.0.1",
+  "title": "Update",
+  "summary": "Release notes, changelogs, weekly updates, announcements. 16:9 and 1:1, skimmable.",
+  "domains": ["product", "tech", "internal-comms"],
+  "discover": {
+    "useCases": [
+      "Summarise a release: headline changes, one screenshot and what to try next.",
+      "List versioned changes from a changelog as a skimmable timeline.",
+      "Give a team its period progress, upcoming work and blockers.",
+      "Announce a change or policy with the reason and what happens next."
+    ],
+    "audience": ["users", "customers", "teammates", "stakeholders"],
+    "goodFor": "Telling people what changed, with 3-7 short items and one takeaway.",
+    "notFor": "KPI-heavy reviews (report), step-by-step teaching (guide), persuasion (pitch).",
+    "tags": [
+      "update",
+      "release-notes",
+      "changelog",
+      "status",
+      "internal",
+      "timeline",
+      "announce",
+      "product"
+    ],
+    "tone": ["calm", "direct"],
+    "aspects": ["16:9", "1:1"]
+  },
+  "requires": {
+    "storyboard": 1,
+    "scenes": [
+      "title",
+      "icon-grid",
+      "media-frame",
+      "timeline",
+      "code",
+      "bullets",
+      "kpi-grid",
+      "callout",
+      "outro"
+    ]
+  },
+  "themes": [
+    { "id": "calm-light", "file": "@shared/calm-light.json", "mode": "light", "pair": "calm-dark" },
+    { "id": "calm-dark", "file": "@shared/calm-dark.json", "mode": "dark", "pair": "calm-light" },
+    { "id": "bold-light", "file": "@shared/bold-light.json", "mode": "light", "pair": "bold-dark" },
+    { "id": "bold-dark", "file": "@shared/bold-dark.json", "mode": "dark", "pair": "bold-light" },
+    { "id": "tech-light", "file": "@shared/tech-light.json", "mode": "light", "pair": "tech-dark" },
+    { "id": "tech-dark", "file": "@shared/tech-dark.json", "mode": "dark", "pair": "tech-light" }
+  ],
+  "styles": [
+    { "id": "tidy", "file": "styles/tidy.json" },
+    { "id": "punchy", "file": "styles/punchy.json" },
+    { "id": "techdark", "file": "styles/techdark.json" }
+  ],
+  "blueprints": [
+    { "id": "release-notes", "file": "blueprints/release-notes.json" },
+    { "id": "changelog", "file": "blueprints/changelog.json" },
+    { "id": "weekly-update", "file": "blueprints/weekly-update.json" },
+    { "id": "announcement", "file": "blueprints/announcement.json" }
+  ],
+  "pacing": "pacing.json",
+  "copy": "copy.md",
+  "license": "Apache-2.0"
+}

package/templates/vista/blueprints/spotlight.json

@@ -0,0 +1,68 @@
+{
+  "discover": {
+    "audience": ["customers", "prospects", "learners"],
+    "aspects": ["16:9", "1:1"],
+    "goodFor": "One 3D highlight with a caption and a single takeaway.",
+    "lengths": { "max": 40, "min": 20 },
+    "notFor": "Multi-stop tours (tour), data or steps (datastory, guide).",
+    "tags": ["product", "announce", "promo", "marketing"],
+    "tone": ["cinematic", "calm"],
+    "useCases": [
+      "Show one place, object or idea as a 3D diorama with a caption.",
+      "Open a demo with a single visual hook and one takeaway.",
+      "Add a voice-ready caption line to a 3D view."
+    ]
+  },
+  "example": {
+    "caption": "Ferries cross while cranes load the morning boats",
+    "cta": "Plan a visit",
+    "focus": "Harbor at dawn",
+    "sceneCaption": "Cranes, ferries and gulls in motion",
+    "subtitle": "A working port in miniature",
+    "takeaway": "A living harbor, distilled to one glance",
+    "title": "Harbor at dawn"
+  },
+  "id": "spotlight",
+  "meta": { "lang": "en", "title": { "$slot": "title" } },
+  "purpose": "Show one highlight in 20-40s: title, a 3D diorama, a caption line, one takeaway, close.",
+  "scenes": [
+    {
+      "id": "intro",
+      "props": {
+        "kicker": "Spotlight",
+        "subtitle": { "$slot": "subtitle" },
+        "title": { "$slot": "title" }
+      },
+      "type": "title"
+    },
+    {
+      "id": "feature",
+      "props": { "caption": { "$slot": "sceneCaption" }, "title": { "$slot": "focus" } },
+      "type": "scene3d"
+    },
+    {
+      "id": "cap",
+      "layer": "overlay",
+      "over": "feature",
+      "props": { "text": { "$slot": "caption" } },
+      "type": "caption"
+    },
+    {
+      "id": "point",
+      "props": { "kind": "statement", "label": "Takeaway", "text": { "$slot": "takeaway" } },
+      "type": "callout"
+    },
+    { "id": "end", "props": { "title": { "$slot": "cta" } }, "type": "outro" }
+  ],
+  "slots": {
+    "caption": { "max": 140, "required": true, "type": "text" },
+    "cta": { "max": 40, "required": true, "type": "text" },
+    "focus": { "max": 60, "required": true, "type": "text" },
+    "length": { "default": "standard", "type": "enum", "values": ["short", "standard", "long"] },
+    "sceneCaption": { "max": 140, "optional": true, "type": "text" },
+    "style": { "default": "cinematic", "type": "enum", "values": ["cinematic", "bright"] },
+    "subtitle": { "max": 90, "optional": true, "type": "text" },
+    "takeaway": { "max": 120, "required": true, "type": "text" },
+    "title": { "max": 60, "required": true, "type": "text" }
+  }
+}

package/templates/vista/blueprints/tour.json

@@ -0,0 +1,84 @@
+{
+  "discover": {
+    "audience": ["customers", "learners", "stakeholders"],
+    "aspects": ["16:9"],
+    "goodFor": "Two or three 3D stops with captions and one closing takeaway.",
+    "lengths": { "max": 60, "min": 30 },
+    "notFor": "Single highlights (spotlight), data or procedures (datastory, guide).",
+    "tags": ["product", "event", "promo", "announce", "marketing"],
+    "tone": ["cinematic", "calm"],
+    "useCases": [
+      "Walk through two or three stops of a space, release or idea in order.",
+      "Pair each 3D view with a short caption the narrator can read.",
+      "Close a short tour with one takeaway and a next step."
+    ]
+  },
+  "example": {
+    "caption1": "Boats rest under morning light",
+    "caption2": "The beam turns once each minute",
+    "cta": "Plan a visit",
+    "stop1": "North pier",
+    "stop2": "Old lighthouse",
+    "takeaway": "Small harbors share one calm rhythm",
+    "title": "Three quiet harbors"
+  },
+  "id": "tour",
+  "meta": { "lang": "en", "title": { "$slot": "title" } },
+  "purpose": "Tour two or three stops in 30-60s: title, 3D stops with captions, takeaway, close.",
+  "scenes": [
+    {
+      "id": "intro",
+      "props": { "kicker": "Tour", "title": { "$slot": "title" } },
+      "type": "title"
+    },
+    {
+      "id": "stop1",
+      "props": { "caption": { "$slot": "caption1" }, "title": { "$slot": "stop1" } },
+      "type": "scene3d"
+    },
+    {
+      "id": "cap1",
+      "layer": "overlay",
+      "over": "stop1",
+      "props": { "text": { "$slot": "caption1" } },
+      "type": "caption"
+    },
+    {
+      "id": "stop2",
+      "props": { "caption": { "$slot": "caption2" }, "title": { "$slot": "stop2" } },
+      "type": "scene3d"
+    },
+    {
+      "id": "cap2",
+      "layer": "overlay",
+      "over": "stop2",
+      "props": { "text": { "$slot": "caption2" } },
+      "type": "caption"
+    },
+    {
+      "id": "stop3",
+      "props": { "caption": { "$slot": "caption3" }, "title": { "$slot": "stop3" } },
+      "type": "scene3d",
+      "when": "stop3"
+    },
+    {
+      "id": "point",
+      "props": { "kind": "statement", "label": "Takeaway", "text": { "$slot": "takeaway" } },
+      "type": "callout"
+    },
+    { "id": "end", "props": { "title": { "$slot": "cta" } }, "type": "outro" }
+  ],
+  "slots": {
+    "caption1": { "max": 140, "required": true, "type": "text" },
+    "caption2": { "max": 140, "required": true, "type": "text" },
+    "caption3": { "max": 140, "optional": true, "type": "text" },
+    "cta": { "max": 40, "required": true, "type": "text" },
+    "length": { "default": "standard", "type": "enum", "values": ["short", "standard", "long"] },
+    "stop1": { "max": 60, "required": true, "type": "text" },
+    "stop2": { "max": 60, "required": true, "type": "text" },
+    "stop3": { "max": 60, "optional": true, "type": "text" },
+    "style": { "default": "cinematic", "type": "enum", "values": ["cinematic", "bright"] },
+    "takeaway": { "max": 120, "required": true, "type": "text" },
+    "title": { "max": 60, "required": true, "type": "text" }
+  }
+}

package/templates/vista/copy.md

@@ -0,0 +1,18 @@
+# Vista copy guide
+
+Tone: cinematic, calm, concrete. Show the place, then name it.
+
+Do
+- Title: the stop or subject in at most 8 words.
+- 3D scene: one named view; caption is one clause, at most 12 words.
+- Caption line: plain words that a narrator could read aloud.
+- Takeaway: one line, at most 15 words, no new facts.
+- Close with a next step of 2-5 words.
+
+Don't
+- No more than 3 stops, 25 words per scene, one idea per caption.
+- No superlatives you cannot prove (best, stunning, ultimate).
+- No invented numbers, dates or quotes; say only what the view shows.
+- No exclamation marks, emoji, or "simply", "just", "easy".
+
+Vocabulary: "view" not "render", "stop" not "slide", "visit" not "leverage".

package/templates/vista/pacing.json

@@ -0,0 +1,14 @@
+{
+  "lengths": {
+    "long": { "scenes": [4, 8], "totalSec": [30, 75] },
+    "short": { "scenes": [3, 6], "totalSec": [10, 40] },
+    "standard": { "scenes": [3, 7], "totalSec": [15, 60] }
+  },
+  "sceneSeconds": {
+    "callout": { "long": 5, "short": 3, "standard": 4 },
+    "outro": { "long": 5, "short": 3, "standard": 4 },
+    "scene3d": { "long": 11, "short": 6, "standard": 8 },
+    "title": { "long": 5, "short": 3, "standard": 4 }
+  },
+  "wordsPerSecond": 2.5
+}

package/templates/vista/styles/bright.json

@@ -0,0 +1,6 @@
+{
+  "direction": { "ease": "out", "move": "push-in", "shot": "medium", "transition": "cut" },
+  "frame": { "fps": 30, "height": 1080, "width": 1920 },
+  "id": "bright",
+  "theme": "fjord-light"
+}

package/templates/vista/styles/cinematic.json

@@ -0,0 +1,6 @@
+{
+  "direction": { "ease": "out", "move": "push-in", "shot": "close", "transition": "crossfade" },
+  "frame": { "fps": 30, "height": 1080, "width": 1920 },
+  "id": "cinematic",
+  "theme": "fjord-dark"
+}