@anvpx/motion-templates 0.0.0-stage → 0.1.0

package/templates/social/blueprints/tip.json

@@ -0,0 +1,114 @@
+{
+  "id": "tip",
+  "purpose": "A vertical tip clip: a big hook card, 2-4 short tip points, and a call to action.",
+  "discover": {
+    "useCases": [
+      "Share one quick tip as a short vertical clip for TikTok, Reels or Shorts.",
+      "Teach a habit or trick in under 30 seconds with a hook and three points.",
+      "Turn one piece of advice into a punchy clip that ends with a call to action."
+    ],
+    "audience": ["followers", "customers", "community"],
+    "goodFor": "One idea told as a hook and 2-4 points, 12-26 s, vertical.",
+    "notFor": "Step-by-step lessons (guide), long explanations (explain), news (announce).",
+    "tags": ["social", "vertical", "tip", "marketing", "lesson"],
+    "tone": ["punchy", "friendly"],
+    "aspects": ["9:16", "1:1"],
+    "lengths": {
+      "min": 12,
+      "max": 26
+    }
+  },
+  "slots": {
+    "hook": {
+      "type": "text",
+      "max": 50,
+      "required": true
+    },
+    "tips": {
+      "type": "text[]",
+      "min": 2,
+      "max": 4,
+      "itemMax": 26,
+      "required": true
+    },
+    "cta": {
+      "type": "text",
+      "max": 36,
+      "required": true
+    },
+    "handle": {
+      "type": "text",
+      "max": 24,
+      "optional": true
+    },
+    "platform": {
+      "type": "enum",
+      "values": ["tiktok", "reels", "shorts"],
+      "default": "tiktok"
+    },
+    "length": {
+      "type": "enum",
+      "values": ["short", "standard", "long"],
+      "default": "standard"
+    },
+    "style": {
+      "type": "enum",
+      "values": ["hook-first", "captioned", "techcut"],
+      "default": "hook-first"
+    }
+  },
+  "example": {
+    "hook": "Stop [doing this]",
+    "tips": ["Batch your tasks", "Mute alerts", "Plan tomorrow"],
+    "cta": "Follow for more",
+    "handle": "@briar.labs"
+  },
+  "meta": {
+    "title": {
+      "$slot": "cta"
+    },
+    "lang": "en"
+  },
+  "scenes": [
+    {
+      "id": "hook",
+      "type": "callout",
+      "props": {
+        "kind": "tip",
+        "text": {
+          "$slot": "hook"
+        }
+      }
+    },
+    {
+      "id": "tips",
+      "type": "bullets",
+      "props": {
+        "items": {
+          "$slot": "tips"
+        }
+      }
+    },
+    {
+      "id": "progress",
+      "layer": "overlay",
+      "type": "progress",
+      "over": "tips",
+      "props": {}
+    },
+    {
+      "id": "end",
+      "type": "icon-grid",
+      "props": {
+        "title": {
+          "$slot": "cta"
+        },
+        "cols": 2,
+        "items": [
+          { "icon": "bookmark", "label": "Save", "detail": "later" },
+          { "icon": "user-plus", "label": "Follow", "detail": { "$slot": "handle" } }
+        ]
+      }
+    }
+  ]
+}

package/templates/social/copy.md

@@ -0,0 +1,18 @@
+# Social copy guide
+
+Tone: punchy, friendly, direct. Speak to one viewer. The hook is the whole promise.
+
+Do
+- Hook in 2-5 words, first second: a claim, a question or a number; wrap the 1-2 key words in [brackets] ("Stop [doing this]").
+- One point per beat: 2-4 words, no full stop. Verbs first ("Batch your tasks").
+- Number items when order matters ("3 habits"); one big number per announcement.
+- End with one action in <= 5 words ("Follow for more", "Save this") and the handle in the optional `handle` slot; each blueprint ends on its own card (tip: save/share/follow; announce: handle + follow line; listicle: hook recap).
+- <= 14 words on screen at once; keep text away from top, bottom and right edges.
+
+Don't
+- No hashtags, emoji, links or long sentences on screen.
+- No clickbait you do not pay off; no invented figures.
+- No more than 5 list items or 4 tips (more overflows the safe zone); split a longer list into two clips.
+- 14 words or fewer per scene: labels 1-3 words, tips 2-4 words.
+
+Vocabulary: "tip" not "best practice", "save this" not "bookmark for later".

package/templates/social/pacing.json

@@ -0,0 +1,49 @@
+{
+  "wordsPerSecond": 3,
+  "sceneSeconds": {
+    "callout": {
+      "short": 2,
+      "standard": 2.5,
+      "long": 3
+    },
+    "bullets": {
+      "short": 6,
+      "standard": 10,
+      "long": 13
+    },
+    "stat": {
+      "short": 4,
+      "standard": 5,
+      "long": 6
+    },
+    "icon-grid": {
+      "short": 3,
+      "standard": 4,
+      "long": 5
+    },
+    "title": {
+      "short": 3,
+      "standard": 4,
+      "long": 5
+    },
+    "outro": {
+      "short": 3,
+      "standard": 4,
+      "long": 5
+    }
+  },
+  "lengths": {
+    "short": {
+      "scenes": [3, 4],
+      "totalSec": [8, 18]
+    },
+    "standard": {
+      "scenes": [3, 4],
+      "totalSec": [10, 28]
+    },
+    "long": {
+      "scenes": [3, 4],
+      "totalSec": [14, 45]
+    }
+  }
+}

package/templates/social/styles/captioned.json

@@ -0,0 +1,18 @@
+{
+  "id": "captioned",
+  "theme": "bold-dark",
+  "direction": {
+    "shot": "close",
+    "move": "push-in",
+    "ease": "spring-snappy",
+    "transition": "push"
+  },
+  "props": {
+    "bullets": {
+      "marker": "number"
+    },
+    "progress": {
+      "color": "accent2"
+    }
+  }
+}

package/templates/social/styles/hook-first.json

@@ -0,0 +1,15 @@
+{
+  "id": "hook-first",
+  "theme": "pop-dark",
+  "direction": {
+    "shot": "close",
+    "move": "push-in",
+    "ease": "spring-snappy",
+    "transition": "cut"
+  },
+  "props": {
+    "progress": {
+      "color": "accent"
+    }
+  }
+}

package/templates/social/styles/techcut.json

@@ -0,0 +1,15 @@
+{
+  "id": "techcut",
+  "theme": "tech-dark",
+  "direction": {
+    "shot": "close",
+    "move": "push-in",
+    "ease": "spring-snappy",
+    "transition": "cut"
+  },
+  "props": {
+    "progress": {
+      "color": "accent"
+    }
+  }
+}

package/templates/social/template.json

@@ -0,0 +1,94 @@
+{
+  "templateVersion": 1,
+  "id": "social",
+  "version": "1.1.0",
+  "title": "Social",
+  "summary": "Vertical short-form clips: a tip, an announcement or a numbered list. 9:16 and 1:1, hook in the first second.",
+  "domains": ["social", "marketing", "community"],
+  "discover": {
+    "useCases": [
+      "Share one quick tip as a short vertical clip for TikTok, Reels or Shorts.",
+      "Announce news or a launch with one big number and a call to action.",
+      "Post a numbered list of things followers should know."
+    ],
+    "audience": ["followers", "customers", "community"],
+    "goodFor": "Vertical clips of 12-30 s with a one-line hook, 2-4 short points and a call to action.",
+    "notFor": "Long or dense explanations (explain), step-by-step lessons (guide), data reviews (report).",
+    "tags": ["social", "vertical", "tip", "listicle", "announce", "promo", "marketing"],
+    "tone": ["punchy", "friendly"],
+    "aspects": ["9:16", "1:1"]
+  },
+  "requires": {
+    "storyboard": 1,
+    "scenes": ["callout", "bullets", "stat", "outro", "progress", "icon-grid", "title"]
+  },
+  "themes": [
+    {
+      "id": "pop-light",
+      "file": "@shared/pop-light.json",
+      "mode": "light",
+      "pair": "pop-dark"
+    },
+    {
+      "id": "pop-dark",
+      "file": "@shared/pop-dark.json",
+      "mode": "dark",
+      "pair": "pop-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": "hook-first",
+      "file": "styles/hook-first.json"
+    },
+    {
+      "id": "captioned",
+      "file": "styles/captioned.json"
+    },
+    {
+      "id": "techcut",
+      "file": "styles/techcut.json"
+    }
+  ],
+  "blueprints": [
+    {
+      "id": "tip",
+      "file": "blueprints/tip.json"
+    },
+    {
+      "id": "announce",
+      "file": "blueprints/announce.json"
+    },
+    {
+      "id": "listicle",
+      "file": "blueprints/listicle.json"
+    }
+  ],
+  "pacing": "pacing.json",
+  "copy": "copy.md",
+  "license": "Apache-2.0"
+}

package/templates/update/blueprints/announcement.json

@@ -0,0 +1,57 @@
+{
+  "id": "announcement",
+  "purpose": "Announce one change: headline, the reason in one sentence, 2-4 things that change, and who to ask.",
+  "discover": {
+    "useCases": [
+      "Announce a change or policy with the reason and what happens next.",
+      "Tell a team or customer base about a date, a move or a new process.",
+      "Explain what changes for people and where to ask questions."
+    ],
+    "audience": ["teammates", "customers", "stakeholders"],
+    "goodFor": "One change with a reason, 2-4 consequences and a contact.",
+    "notFor": "Many changes (changelog), a product release (release-notes).",
+    "tags": ["update", "announce", "internal", "news", "status"],
+    "tone": ["calm", "direct"],
+    "aspects": ["16:9", "1:1"],
+    "lengths": { "min": 20, "max": 45 }
+  },
+  "slots": {
+    "headline": { "type": "text", "max": 60, "required": true },
+    "why": { "type": "text", "max": 110, "required": true },
+    "what": { "type": "text[]", "min": 2, "max": 4, "itemMax": 50, "required": true },
+    "date": { "type": "text", "max": 30, "optional": true },
+    "contact": { "type": "text", "max": 60, "default": "Questions? Ask in the help channel" },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["tidy", "punchy", "techdark"], "default": "tidy" }
+  },
+  "example": {
+    "headline": "A new review process",
+    "why": "Reviews are [slow] today; a shared [checklist] makes them faster and fairer.",
+    "what": ["One checklist for every review", "Two reviewers per change", "Replies within a day"],
+    "date": "Starts Nov 4",
+    "contact": "Questions? Ask in the help channel"
+  },
+  "meta": { "title": { "$slot": "headline" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": {
+        "kicker": "Announcement",
+        "title": { "$slot": "headline" },
+        "subtitle": { "$slot": "date" }
+      }
+    },
+    {
+      "id": "reason",
+      "type": "callout",
+      "props": { "text": { "$slot": "why" }, "kind": "statement", "label": "Why" }
+    },
+    {
+      "id": "changes",
+      "type": "bullets",
+      "props": { "title": "What changes", "items": { "$slot": "what" }, "marker": "check" }
+    },
+    { "id": "end", "type": "outro", "props": { "title": { "$slot": "contact" } } }
+  ]
+}

package/templates/update/blueprints/changelog.json

@@ -0,0 +1,157 @@
+{
+  "id": "changelog",
+  "purpose": "Show 3-7 dated versions on a timeline, optionally followed by a short code or command example.",
+  "discover": {
+    "useCases": [
+      "Turn a list of versioned changes into a skimmable timeline.",
+      "Recap what shipped over several releases, newest last, with dates.",
+      "Show a short command or snippet that goes with the latest change."
+    ],
+    "audience": ["users", "engineers", "customers"],
+    "goodFor": "3-7 versions or dates, each with one short summary.",
+    "notFor": "One big release (release-notes), progress with blockers (weekly-update).",
+    "tags": ["update", "changelog", "timeline", "release-notes", "dev", "history"],
+    "tone": ["calm", "technical"],
+    "aspects": ["16:9", "1:1"],
+    "lengths": {
+      "min": 25,
+      "max": 65
+    }
+  },
+  "slots": {
+    "product": {
+      "type": "text",
+      "max": 40,
+      "required": true
+    },
+    "entries": {
+      "type": "object",
+      "fields": {
+        "when": "text",
+        "label": "text",
+        "detail": "text"
+      },
+      "list": true,
+      "min": 3,
+      "max": 7,
+      "required": true
+    },
+    "code": {
+      "type": "text[]",
+      "min": 1,
+      "max": 14,
+      "itemMax": 60,
+      "optional": true
+    },
+    "lang": {
+      "type": "enum",
+      "values": ["js", "ts", "json", "py", "sh", "plain"],
+      "default": "sh"
+    },
+    "file": {
+      "type": "text",
+      "max": 40,
+      "optional": true
+    },
+    "length": {
+      "type": "enum",
+      "values": ["short", "standard", "long"],
+      "default": "standard"
+    },
+    "style": {
+      "type": "enum",
+      "values": ["tidy", "punchy", "techdark"],
+      "default": "tidy"
+    }
+  },
+  "example": {
+    "product": "Briar SDK",
+    "entries": [
+      {
+        "when": "Aug 12",
+        "label": "v2.0",
+        "detail": "Plugins"
+      },
+      {
+        "when": "Aug 30",
+        "label": "v2.1",
+        "detail": "Faster builds"
+      },
+      {
+        "when": "Sep 18",
+        "label": "v2.2",
+        "detail": "Dark mode"
+      },
+      {
+        "when": "Oct 07",
+        "label": "v2.3",
+        "detail": "Fixes"
+      },
+      {
+        "when": "Oct 28",
+        "label": "v2.4",
+        "detail": "Offline mode"
+      }
+    ],
+    "code": [
+      "$ briar upgrade --to 2.4",
+      "Resolving packages",
+      "Updated 5 packages in 3.1s",
+      "$ briar status",
+      "Version 2.4 is ready"
+    ],
+    "lang": "sh",
+    "file": "terminal"
+  },
+  "meta": {
+    "title": {
+      "$slot": "product"
+    },
+    "lang": "en"
+  },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": {
+        "kicker": "Changelog",
+        "title": {
+          "$slot": "product"
+        }
+      }
+    },
+    {
+      "id": "versions",
+      "type": "timeline",
+      "props": {
+        "title": "What shipped",
+        "items": {
+          "$slot": "entries"
+        }
+      }
+    },
+    {
+      "when": "code",
+      "id": "snippet",
+      "type": "code",
+      "props": {
+        "lines": {
+          "$slot": "code"
+        },
+        "lang": {
+          "$slot": "lang"
+        },
+        "file": {
+          "$slot": "file"
+        }
+      }
+    },
+    {
+      "id": "end",
+      "type": "outro",
+      "props": {
+        "title": "Read the full notes"
+      }
+    }
+  ]
+}