Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions Video/MistKitStory/.gitignore
Original file line number Diff line number Diff line change
@@ -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
44 changes: 44 additions & 0 deletions Video/MistKitStory/README.md
Original file line number Diff line number Diff line change
@@ -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-<phase>` | One branch per phase, e.g. `video/mistkit-story-01-scaffolding`, `video/mistkit-story-02-outline`. |

Phase branches use a `-NN-<phase>` suffix rather than `video/mistkit-story/<phase>` 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: `<chapter>-<nn>`, e.g. `03-04`.
- Motion spec IDs: `M-<slug>`, e.g. `M-three-layers`.
- Status values: `todo` · `draft` · `review` · `final`.
19 changes: 19 additions & 0 deletions Video/MistKitStory/motion/README.md
Original file line number Diff line number Diff line change
@@ -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-<slug> — Title

- Chapter: NN
- Duration: TODO
- Status: todo

## What it shows
## Source reference (article § / slide #)
## Beats
1. TODO
## Style notes
```
21 changes: 21 additions & 0 deletions Video/MistKitStory/motion/specs/auth-methods-by-database.md
Original file line number Diff line number Diff line change
@@ -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
21 changes: 21 additions & 0 deletions Video/MistKitStory/motion/specs/ckws-request-flow.md
Original file line number Diff line number Diff line change
@@ -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
21 changes: 21 additions & 0 deletions Video/MistKitStory/motion/specs/fieldvalue-polymorphism.md
Original file line number Diff line number Diff line change
@@ -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
21 changes: 21 additions & 0 deletions Video/MistKitStory/motion/specs/three-layers.md
Original file line number Diff line number Diff line change
@@ -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
21 changes: 21 additions & 0 deletions Video/MistKitStory/motion/specs/timeline.md
Original file line number Diff line number Diff line change
@@ -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
56 changes: 56 additions & 0 deletions Video/MistKitStory/outline/outline.md
Original file line number Diff line number Diff line change
@@ -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
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/00-cold-open.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
chapter: "00"
title: "Cold open"
target_duration: TODO
sources:
- TODO
status: todo
---

# 00 · Cold open

| VO | Visual |
|----|--------|
| TODO | TODO |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/01-what-is-cloudkit.md
Original file line number Diff line number Diff line change
@@ -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 |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/02-cloudkit-web-services.md
Original file line number Diff line number Diff line change
@@ -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 |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/03-why-server-side.md
Original file line number Diff line number Diff line change
@@ -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 |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/04-building-mistkit.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
chapter: "04"
title: "Building MistKit"
target_duration: TODO
sources:
- TODO
status: todo
---

# 04 · Building MistKit

| VO | Visual |
|----|--------|
| TODO | TODO |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/05-authentication.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
chapter: "05"
title: "Authentication"
target_duration: TODO
sources:
- TODO
status: todo
---

# 05 · Authentication

| VO | Visual |
|----|--------|
| TODO | TODO |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/06-field-type-polymorphism.md
Original file line number Diff line number Diff line change
@@ -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 |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/07-error-handling.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
chapter: "07"
title: "Error handling"
target_duration: TODO
sources:
- TODO
status: todo
---

# 07 · Error handling

| VO | Visual |
|----|--------|
| TODO | TODO |
14 changes: 14 additions & 0 deletions Video/MistKitStory/script/08-deployment.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
chapter: "08"
title: "Deployment"
target_duration: TODO
sources:
- TODO
status: todo
---

# 08 · Deployment

| VO | Visual |
|----|--------|
| TODO | TODO |
Loading
Loading