diff --git a/Video/MistKitStory/.gitignore b/Video/MistKitStory/.gitignore new file mode 100644 index 00000000..b315101d --- /dev/null +++ b/Video/MistKitStory/.gitignore @@ -0,0 +1,24 @@ +# Keep only text sources in git; media lives outside the repo. +footage/ +audio/ +renders/ +exports/ +proxies/ +cache/ +*.mov +*.mp4 +*.m4v +*.mkv +*.wav +*.aif +*.aiff +*.m4a +*.mp3 +*.braw +*.fcpbundle/ +*.prproj +*.drp +*.psd +motion/project/node_modules/ +motion/project/out/ +.DS_Store diff --git a/Video/MistKitStory/README.md b/Video/MistKitStory/README.md new file mode 100644 index 00000000..ad1f1208 --- /dev/null +++ b/Video/MistKitStory/README.md @@ -0,0 +1,44 @@ +# The Story of MistKit — YouTube Video + +Working folder for a YouTube video based on the talk **"CloudKit as Your Backend: From iOS to Server-Side Swift"** (Swift Craft and iOSDevUK 2026): the story of MistKit and CloudKit Web Services. + +Only text sources (outline, script, shot list, motion specs, metadata) live in git. Raw footage, audio, renders and NLE caches are ignored — see [`.gitignore`](.gitignore). + +## Branch model + +| Branch | Role | +|--------|------| +| `video/mistkit-story` | Base branch for the video project. Each phase branches from here and merges back. | +| `video/mistkit-story-NN-` | One branch per phase, e.g. `video/mistkit-story-01-scaffolding`, `video/mistkit-story-02-outline`. | + +Phase branches use a `-NN-` suffix rather than `video/mistkit-story/` because Git can't hold a ref and a sub-ref with the same prefix. + +## Workflow + +1. **Sources** — gather the article, slides, recording and transcript → [`sources/`](sources/) +2. **Outline** — chapter structure with source references → [`outline/outline.md`](outline/outline.md) +3. **Script** — one file per chapter, VO | Visual → [`script/`](script/) +4. **Shots** — shot list and B-roll captures → [`shots/`](shots/) +5. **Motion** — diagram/animation specs (and project files) → [`motion/`](motion/) +6. **Edit** — done outside git +7. **Publish** — thumbnail, title, description, chapters → [`thumbnails/`](thumbnails/), [`youtube/`](youtube/) + +## Folder map + +``` +Video/MistKitStory/ +├── sources/ pointers to source material; transcript/ drop spot +├── outline/ chapter skeleton +├── script/ per-chapter script files +├── shots/ shot list, B-roll ideas +├── motion/ motion-graphics specs (specs/) and project files (project/) +├── thumbnails/ thumbnail brief +└── youtube/ metadata and chapter markers +``` + +## Conventions + +- Chapter IDs are two-digit and shared across outline, script and shots: `00`, `01`, … +- Shot IDs: `-`, e.g. `03-04`. +- Motion spec IDs: `M-`, e.g. `M-three-layers`. +- Status values: `todo` · `draft` · `review` · `final`. diff --git a/Video/MistKitStory/motion/README.md b/Video/MistKitStory/motion/README.md new file mode 100644 index 00000000..ba51f1bc --- /dev/null +++ b/Video/MistKitStory/motion/README.md @@ -0,0 +1,19 @@ +# Motion Graphics + +Tool-agnostic specs live in [`specs/`](specs/), one file per graphic. Project files for whichever tool renders them (Remotion, Apple Motion, Keynote, …) go in `motion/project/`; renders are gitignored. + +## Spec template + +```markdown +# M- — Title + +- Chapter: NN +- Duration: TODO +- Status: todo + +## What it shows +## Source reference (article § / slide #) +## Beats +1. TODO +## Style notes +``` diff --git a/Video/MistKitStory/motion/specs/auth-methods-by-database.md b/Video/MistKitStory/motion/specs/auth-methods-by-database.md new file mode 100644 index 00000000..26e08421 --- /dev/null +++ b/Video/MistKitStory/motion/specs/auth-methods-by-database.md @@ -0,0 +1,21 @@ +# M-auth-methods-by-database — Authentication methods by database + +- Chapter: 05 +- Duration: TODO +- Status: todo + +## What it shows + +TODO + +## Source reference (article § / slide #) + +TODO + +## Beats + +1. TODO + +## Style notes + +TODO diff --git a/Video/MistKitStory/motion/specs/ckws-request-flow.md b/Video/MistKitStory/motion/specs/ckws-request-flow.md new file mode 100644 index 00000000..d5c1c128 --- /dev/null +++ b/Video/MistKitStory/motion/specs/ckws-request-flow.md @@ -0,0 +1,21 @@ +# M-ckws-request-flow — CloudKit Web Services request flow + +- Chapter: 02 +- Duration: TODO +- Status: todo + +## What it shows + +TODO + +## Source reference (article § / slide #) + +TODO + +## Beats + +1. TODO + +## Style notes + +TODO diff --git a/Video/MistKitStory/motion/specs/fieldvalue-polymorphism.md b/Video/MistKitStory/motion/specs/fieldvalue-polymorphism.md new file mode 100644 index 00000000..cd81b308 --- /dev/null +++ b/Video/MistKitStory/motion/specs/fieldvalue-polymorphism.md @@ -0,0 +1,21 @@ +# M-fieldvalue-polymorphism — Field type polymorphism + +- Chapter: 06 +- Duration: TODO +- Status: todo + +## What it shows + +TODO + +## Source reference (article § / slide #) + +TODO + +## Beats + +1. TODO + +## Style notes + +TODO diff --git a/Video/MistKitStory/motion/specs/three-layers.md b/Video/MistKitStory/motion/specs/three-layers.md new file mode 100644 index 00000000..80d7d225 --- /dev/null +++ b/Video/MistKitStory/motion/specs/three-layers.md @@ -0,0 +1,21 @@ +# M-three-layers — MistKit's three layers + +- Chapter: 04 +- Duration: TODO +- Status: todo + +## What it shows + +TODO + +## Source reference (article § / slide #) + +TODO + +## Beats + +1. TODO + +## Style notes + +TODO diff --git a/Video/MistKitStory/motion/specs/timeline.md b/Video/MistKitStory/motion/specs/timeline.md new file mode 100644 index 00000000..a9c9954d --- /dev/null +++ b/Video/MistKitStory/motion/specs/timeline.md @@ -0,0 +1,21 @@ +# M-timeline — CloudKit & MistKit timeline + +- Chapter: 00 +- Duration: TODO +- Status: todo + +## What it shows + +TODO + +## Source reference (article § / slide #) + +TODO + +## Beats + +1. TODO + +## Style notes + +TODO diff --git a/Video/MistKitStory/outline/outline.md b/Video/MistKitStory/outline/outline.md new file mode 100644 index 00000000..3dd73e24 --- /dev/null +++ b/Video/MistKitStory/outline/outline.md @@ -0,0 +1,56 @@ +# Outline + +Chapter skeleton. Headings mirror the article / slide order as a starting point — reorder, merge or cut freely. + +| ID | Chapter | Article § | Slides | Transcript | Target | Status | +|----|---------|-----------|--------|------------|--------|--------| +| 00 | Cold open | — | | | | todo | +| 01 | What is CloudKit | What is CloudKit | | | | todo | +| 02 | What is CloudKit Web Services | What is CloudKit Web Services | | | | todo | +| 03 | Why server-side CloudKit | Why server-side CloudKit | | | | todo | +| 04 | Building MistKit | Building MistKit | | | | todo | +| 05 | Authentication | Authentication | | | | todo | +| 06 | Field type polymorphism | Field type polymorphism | | | | todo | +| 07 | Error handling | Error handling | | | | todo | +| 08 | Deployment | Deployment | | | | todo | +| 09 | What's next / outro | What's next | | | | todo | + +## 00 · Cold open + +- TODO + +## 01 · What is CloudKit + +- TODO + +## 02 · What is CloudKit Web Services + +- TODO + +## 03 · Why server-side CloudKit + +- TODO + +## 04 · Building MistKit + +- TODO + +## 05 · Authentication + +- TODO + +## 06 · Field type polymorphism + +- TODO + +## 07 · Error handling + +- TODO + +## 08 · Deployment + +- TODO + +## 09 · What's next / outro + +- TODO diff --git a/Video/MistKitStory/script/00-cold-open.md b/Video/MistKitStory/script/00-cold-open.md new file mode 100644 index 00000000..f488867f --- /dev/null +++ b/Video/MistKitStory/script/00-cold-open.md @@ -0,0 +1,14 @@ +--- +chapter: "00" +title: "Cold open" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 00 · Cold open + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/01-what-is-cloudkit.md b/Video/MistKitStory/script/01-what-is-cloudkit.md new file mode 100644 index 00000000..ab80e263 --- /dev/null +++ b/Video/MistKitStory/script/01-what-is-cloudkit.md @@ -0,0 +1,14 @@ +--- +chapter: "01" +title: "What is CloudKit" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 01 · What is CloudKit + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/02-cloudkit-web-services.md b/Video/MistKitStory/script/02-cloudkit-web-services.md new file mode 100644 index 00000000..d9f76001 --- /dev/null +++ b/Video/MistKitStory/script/02-cloudkit-web-services.md @@ -0,0 +1,14 @@ +--- +chapter: "02" +title: "What is CloudKit Web Services" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 02 · What is CloudKit Web Services + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/03-why-server-side.md b/Video/MistKitStory/script/03-why-server-side.md new file mode 100644 index 00000000..7a7a81ba --- /dev/null +++ b/Video/MistKitStory/script/03-why-server-side.md @@ -0,0 +1,14 @@ +--- +chapter: "03" +title: "Why server-side CloudKit" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 03 · Why server-side CloudKit + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/04-building-mistkit.md b/Video/MistKitStory/script/04-building-mistkit.md new file mode 100644 index 00000000..5c793cea --- /dev/null +++ b/Video/MistKitStory/script/04-building-mistkit.md @@ -0,0 +1,14 @@ +--- +chapter: "04" +title: "Building MistKit" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 04 · Building MistKit + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/05-authentication.md b/Video/MistKitStory/script/05-authentication.md new file mode 100644 index 00000000..1b93e681 --- /dev/null +++ b/Video/MistKitStory/script/05-authentication.md @@ -0,0 +1,14 @@ +--- +chapter: "05" +title: "Authentication" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 05 · Authentication + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/06-field-type-polymorphism.md b/Video/MistKitStory/script/06-field-type-polymorphism.md new file mode 100644 index 00000000..11dc2e32 --- /dev/null +++ b/Video/MistKitStory/script/06-field-type-polymorphism.md @@ -0,0 +1,14 @@ +--- +chapter: "06" +title: "Field type polymorphism" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 06 · Field type polymorphism + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/07-error-handling.md b/Video/MistKitStory/script/07-error-handling.md new file mode 100644 index 00000000..a5d138ea --- /dev/null +++ b/Video/MistKitStory/script/07-error-handling.md @@ -0,0 +1,14 @@ +--- +chapter: "07" +title: "Error handling" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 07 · Error handling + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/08-deployment.md b/Video/MistKitStory/script/08-deployment.md new file mode 100644 index 00000000..0f14279b --- /dev/null +++ b/Video/MistKitStory/script/08-deployment.md @@ -0,0 +1,14 @@ +--- +chapter: "08" +title: "Deployment" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 08 · Deployment + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/09-whats-next.md b/Video/MistKitStory/script/09-whats-next.md new file mode 100644 index 00000000..1598465a --- /dev/null +++ b/Video/MistKitStory/script/09-whats-next.md @@ -0,0 +1,14 @@ +--- +chapter: "09" +title: "What's next / outro" +target_duration: TODO +sources: + - TODO +status: todo +--- + +# 09 · What's next / outro + +| VO | Visual | +|----|--------| +| TODO | TODO | diff --git a/Video/MistKitStory/script/README.md b/Video/MistKitStory/script/README.md new file mode 100644 index 00000000..b2c19c49 --- /dev/null +++ b/Video/MistKitStory/script/README.md @@ -0,0 +1,11 @@ +# Script + +One file per chapter, named `-.md` to match [`../outline/outline.md`](../outline/outline.md). + +Each file has frontmatter (`chapter`, `title`, `target_duration`, `sources`, `status`) and a two-column table: + +| VO | Visual | +|----|--------| +| What is said | Shot ID (`03-04`), motion spec (`M-three-layers`), slide #, or screen capture | + +Keep one beat per row so the shot list can be generated from the Visual column. diff --git a/Video/MistKitStory/shots/broll-ideas.md b/Video/MistKitStory/shots/broll-ideas.md new file mode 100644 index 00000000..7c6ffc6a --- /dev/null +++ b/Video/MistKitStory/shots/broll-ideas.md @@ -0,0 +1,23 @@ +# B-roll Ideas + +Candidate captures — promote to [`shot-list.md`](shot-list.md) once they're in the script. + +## Apps & tools +- [ ] CloudKit Console — container, record types, records +- [ ] Xcode — CloudKit capability, schema +- [ ] Bushel / Heartwitch / Celestra apps +- [ ] Archived CloudKit Web Services Reference (revision history: last updated 2016) + +## Code +- [ ] `openapi.yaml` +- [ ] Generated client in `Sources/MistKitOpenAPI/` +- [ ] Authentication middleware / authenticators +- [ ] `FieldValue` + +## Terminal / demos +- [ ] `swift run mistdemo` commands (`Examples/MistDemo`) +- [ ] BushelCloud sync run +- [ ] GitHub Actions scheduled workflow run + +## Other +- [ ] TODO diff --git a/Video/MistKitStory/shots/shot-list.md b/Video/MistKitStory/shots/shot-list.md new file mode 100644 index 00000000..55ad1fa0 --- /dev/null +++ b/Video/MistKitStory/shots/shot-list.md @@ -0,0 +1,7 @@ +# Shot List + +Types: `A-roll` (talking head) · `screen` (screen recording) · `slide` · `motion` · `B-roll` · `stage` (talk recording) + +| Shot | Chapter | Type | Description | Source | Status | +|------|---------|------|-------------|--------|--------| +| 00-01 | 00 | | TODO | | todo | diff --git a/Video/MistKitStory/sources/README.md b/Video/MistKitStory/sources/README.md new file mode 100644 index 00000000..5c687500 --- /dev/null +++ b/Video/MistKitStory/sources/README.md @@ -0,0 +1,20 @@ +# Sources + +Everything the outline and script are built from. + +| Source | Location | Notes | +|--------|----------|-------| +| Article | [`Sources/MistKit/Documentation.docc/CloudKitAsYourBackend.md`](../../../Sources/MistKit/Documentation.docc/CloudKitAsYourBackend.md) | Written form of the talk, revised against the iOSDevUK recording; follows slide order | +| Slides (PDF) | [CloudKit-Backend-iOSDevUK.pdf](https://github.com/brightdigit/MistKit/releases/download/1.0.0-beta.5/CloudKit-Backend-iOSDevUK.pdf) | Attached to the `1.0.0-beta.5` release (~12 MB); see [`iOSDevUKTalk.md`](../../../Sources/MistKit/Documentation.docc/iOSDevUKTalk.md) | +| iOSDevUK recording | TODO | | +| Swift Craft recording | TODO | | +| Transcript | [`transcript/`](transcript/) | TODO: drop `.txt` / `.srt` here | +| Links shown in the talk | Article § "Links" | Reuse for the YouTube description | +| Blog: Rebuilding MistKit with Claude Code | [part 1](https://brightdigit.com/tutorials/rebuilding-mistkit-claude-code-part-1/), [part 2](https://brightdigit.com/tutorials/rebuilding-mistkit-claude-code-part-2/) | | + +## Demo / B-roll sources in this repo + +- [`Examples/MistDemo`](../../../Examples/MistDemo) — CLI, macOS app and web demo +- [`Examples/BushelCloud`](../../../Examples/BushelCloud) — server-to-server sync, GitHub Actions deployment +- [`Examples/CelestraCloud`](../../../Examples/CelestraCloud) — RSS sync, query filtering and sorting +- [`openapi.yaml`](../../../openapi.yaml) — the spec diff --git a/Video/MistKitStory/sources/transcript/.gitkeep b/Video/MistKitStory/sources/transcript/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Video/MistKitStory/thumbnails/brief.md b/Video/MistKitStory/thumbnails/brief.md new file mode 100644 index 00000000..74eaa101 --- /dev/null +++ b/Video/MistKitStory/thumbnails/brief.md @@ -0,0 +1,15 @@ +# Thumbnail Brief + +| | | +|-|-| +| Title text (≤ 4 words) | TODO | +| Main image | TODO | +| Supporting imagery | TODO | +| Style reference | TODO | + +## Variants + +| Variant | Text | Image | Notes | +|---------|------|-------|-------| +| A | TODO | | | +| B | TODO | | | diff --git a/Video/MistKitStory/youtube/chapters.md b/Video/MistKitStory/youtube/chapters.md new file mode 100644 index 00000000..a0d7ff71 --- /dev/null +++ b/Video/MistKitStory/youtube/chapters.md @@ -0,0 +1,7 @@ +# Chapters + +Fill after the edit is locked. YouTube needs the first chapter at `00:00`, at least three chapters, each ≥ 10 s. + +```text +00:00 - TODO +``` diff --git a/Video/MistKitStory/youtube/metadata.md b/Video/MistKitStory/youtube/metadata.md new file mode 100644 index 00000000..a8f9f0c3 --- /dev/null +++ b/Video/MistKitStory/youtube/metadata.md @@ -0,0 +1,42 @@ +# YouTube Metadata + +## Title options + +1. TODO +2. TODO +3. TODO + +## Description + +```text +TODO: summary + +CHAPTERS +(see chapters.md) + +LINKS +(see Links below) +``` + +## Links + +Start from the article's "Links" section — `Sources/MistKit/Documentation.docc/CloudKitAsYourBackend.md`. + +- MistKit - https://github.com/brightdigit/MistKit +- TODO + +## Tags + +- TODO + +## End screen & cards + +| Time | Type | Target | +|------|------|--------| +| TODO | | | + +## Settings + +- Playlist: TODO +- Category: TODO +- Captions: TODO