Skip to content

docs: embed instructional video clips across Cloud pages - #44

Open
nellins wants to merge 26 commits into
mainfrom
docs/video-embeds
Open

docs: embed instructional video clips across Cloud pages#44
nellins wants to merge 26 commits into
mainfrom
docs/video-embeds

Conversation

@nellins

@nellins nellins commented Aug 25, 2026

Copy link
Copy Markdown

What

Embeds eight instructional video clips across the Cloud docs — muted, autoplaying, looping MP4s recorded by Drew in Screen Studio and cut in the bm-video Remotion pipeline (title cards, caption pills, instructional pacing).

Page Clip(s)
start-here/quickstart-cloud Meet your workspace (2:53 intro)
cloud/note-editor Editing modes · Frontmatter · Command palette
cloud/comments-and-suggestions Suggest edits → AI reviews them (two-act)
cloud/mcp-app Pocketbook full tour
cloud/themes Theme picker + dark mode
cloud/web-app Import flow (in the Import data section)

How

  • New VideoLoop content component (app/components/content/VideoLoop.vue) mirroring ThemeImage — same border/rounding, autoplay loop muted playsinline preload="metadata".
  • Videos in public/videos/, H.264 CRF 24 faststart, 63MB total (largest: quickstart 17MB).
  • Purely additive: branch cut from freshly-pulled main (7f54c75); only inserted lines in the six content files — no existing text or media touched. Existing screenshots kept alongside the clips.

Verification

  • npm run check:docs passes (pre-existing warnings only).
  • Rendered locally on all six pages; embeds confirmed serving on each route.

Review notes for Paul

  • 63MB of video in git is the one design smell — happy to move these to object storage/CDN and reference by URL if you'd rather keep the repo lean; the component wouldn't change.
  • The demo content is the fictional Lighthouse studio workspace + a fresh onboarding account. One known blemish accepted by Drew: the import clip's Activity panel briefly shows internal entry titles (~0:38–0:41).

🤖 Generated with Claude Code

nellins and others added 2 commits August 25, 2026 11:08
Eight muted looping MP4 demos (Screen Studio takes cut in the bm-video
Remotion pipeline), embedded via a new VideoLoop content component that
mirrors ThemeImage. Purely additive: no existing content modified.

- quickstart-cloud: workspace intro (2:53)
- note-editor: editing modes, frontmatter, command palette
- comments-and-suggestions: suggest edits + AI review
- mcp-app: Pocketbook tour
- themes: theme picker + dark mode
- web-app: import flow (Import data section)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…deo (v30)

Requested by Drew. Same :video embed pattern, now served from the docs
repo; audio track kept since the player has controls.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@nellins

nellins commented Aug 25, 2026

Copy link
Copy Markdown
Author

Added in 72ac0b6 at Drew's request: the what-is-basic-memory page's explainer embed now serves the current hero video (v30) from this repo (public/videos/hero.mp4, 8.5MB, audio kept since the player has controls) instead of the old basicmemory.com/videos/explainer-video.mp4. Same :video embed pattern, one-line src swap — the only non-additive line in this PR, and it's a deliberate content replacement Drew asked for.

Per Drew's review: no autoplay, no loop — controls, scrub, and
fullscreen instead. VideoLoop renamed DocsVideo to match. Every embed
gets a poster of its title card (frame 0 is the blank cream before the
card springs in); the hero gets a mid-video poster frame.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@nellins

nellins commented Aug 25, 2026

Copy link
Copy Markdown
Author

Follow-up per Drew's review of the embeds: autoplay and looping are gone — videos now present as their title-card poster with full controls (play, scrub, fullscreen). Component renamed VideoLoop → DocsVideo accordingly; poster frames added under public/videos/posters/ (544KB total).

nellins and others added 3 commits August 25, 2026 11:30
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… page

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Product naming change per Drew. 33 references across 11 pages, including
both page titles (nav labels follow). URLs/slugs intentionally unchanged
(no redirect infra) — /cloud/mcp-app and /whats-new/interactive-mcp-app
keep their paths.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@nellins

nellins commented Aug 25, 2026

Copy link
Copy Markdown
Author

Heads-up for review: this branch now also carries Drew's product-naming change — Interactive MCP App → Pocketbook throughout (33 refs, 11 pages, titles/nav included). Slugs left unchanged to avoid breaking links; if you want the URLs renamed too that needs redirects and can be a follow-up.

nellins and others added 16 commits August 25, 2026 11:37
Per Drew: hero video on the Welcome page and the Cloud guide (both
introduce Basic Memory broadly); the comments-and-suggestions clip on
AI Collaboration (its second act is exactly that page's review
workflow); the Pocketbook clip on the ChatGPT integration page (the
take was recorded in ChatGPT). Audited and skipped: frontmatter on
concepts/knowledge-format (wrong context), themes/import/palette
elsewhere (passing mentions only).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…o frame

All nine embeds now present identically: cream card, wordmark, serif
title. Rendered from the bm-video StatementCard component.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
'One knowledge base for you, your AI, and your team.' — frame 2.2s of
the hero itself.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Zero new recording — the marketing takes (semantic search, structured
search, schemas, knowledge graph) recut with docs treatment: title
cards, caption pills, click-to-play posters. Placements: schema-system,
semantic-search (also on the v0.23 What's New page — the search
release), metadata-search, and the web-app Explore-the-graph section.
Raw full-display footage, so no cream padding — cards and pills carry
the family style.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Spliced from Drew's two takes: browse existing schemas → ask the AI to
infer a Research schema from the research notes → proposed YAML with
reasoning → save and validate (5/5 pass) → the schema note in the
Schemas folder and conforming notes in Source view. Replaces the
marketing recut, which showed validation only. 90s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…g cut

Per Drew's frame-by-frame review: the Schemas-folder click is now on
camera, redundant note-hopping and a wrong-note detour are excised, and
the clip ends frozen on a research note's type: research frontmatter in
Source view. 77s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ct; pill says 'This project' not 'Lighthouse'

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
From Drew's new take: sidebar Graph click on camera, Project dashboard,
Structured tab, Explore with insights panel, zoom, node focus. Replaces
the marketing recut that started inside the graph. 28s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Folder filter → ⌘K with the scope-pill click on camera → in-project
results → open the found note → ⋮ Pin Note → the Pinned tab payoff.
Search shot ends before the full query surfaces cross-project results.
29s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The Pinned tab briefly re-populated with all notes instead of staying
filtered (~26.3s in the source take). Clip now ends at the last clean
frame — Pinned tab correctly holding just the one note. 28s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The Pinned TAB click (needed to demo the tab payoff) is what triggers a
stale-list render bug downstream, so that beat is cut entirely rather
than risked — the clip now ends on the sidebar's PINNED section holding
the note. Closing pill retargeted to match. 22.6s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Extended the pin beat to show the drag gesture on the sidebar's pinned
entry (tooltip: 'Drag to move note') — it snaps back rather than
completing an unpin, but it's the closest thing to 'unpin from the
sidebar' in the take. Freeze point moved to a settled frame (20.6s,
no tooltip) — the previous freeze at 19.3s landed mid-drag, which
looked like a cursor glitch. 23.6s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Single 14.7s take: sidebar Activity click → the feed dwelt at reading
pace, showing recent notes and AI-made edits. 19s cut.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Recorded in the Claude desktop app (the web app shows Anthropic's
prompt-injection warning banner whenever Pocketbook fills the composer).
Cut for clicks rather than conversation: open → folder grid → folder →
note → full-screen editor with an in-place edit → 'Use this folder'
setting the agent's write location. 49s, native 1844x1080 canvas.

Adds a short 'Open your knowledge base in the conversation' block to the
page's Try It section — the page had no Pocketbook mention at all, so
the clip needed somewhere to live. Copy matches the existing prompt
pattern; flagging it for review since it's new prose, not just an embed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@nellins

nellins commented Aug 25, 2026

Copy link
Copy Markdown
Author

One flag for review in 3b1c114: the Claude Desktop integration page had no mention of Pocketbook at all, so the new clip needed somewhere to live. I added a short **Open your knowledge base in the conversation:** block to that page's Try It section, matching the existing prompt-block pattern (prompt fence + one explanatory paragraph + the video). That's the only new prose in this PR — everything else is embeds and media. Easy to drop if you'd rather the page stay as-is; the clip can move to /cloud/mcp-app instead.

nellins and others added 2 commits August 25, 2026 16:06
Per Drew: the cut skipped the click that hands a note to Claude. Now
shows the full arc — note opens, 'use note in conversation' drops it
into the composer, question typed and sent, Claude answers from the
note's actual contents. 57s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Opens File history, loads the version timeline, compares the diff, and
pulls an earlier line forward with the revert controls until the note is
restored. 32s.

Scope note: the clip ends on the restored note without showing the
Apply click, because Apply is currently broken (basic-memory-cloud
#1829 — the revert controls themselves put unsaved changes in the
editor, which disables Apply). Nothing shown is inaccurate, but re-take
once that's fixed so the clip matches the page's prose, which names
Apply as the commit step.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@nellins

nellins commented Aug 25, 2026

Copy link
Copy Markdown
Author

Added the File history clip in 06f1953 (page: /cloud/file-history).

One scope note worth knowing at review time: the clip ends on the restored note without showing the Apply click, because Apply is currently broken — see basic-memory-cloud#1829. The diff's > revert controls put unsaved changes in the editor, which is exactly what disables Apply, so the documented flow can't currently be filmed end to end.

Nothing in the clip is inaccurate — it shows the timeline, the diff, and pulling an old line forward, and the note genuinely ends up restored (the reverted text autosaves). But the page's prose names Apply as the commit step, so once #1829 is fixed this one is worth a short re-take so video and text line up.

Full recovery arc in one take: create a snapshot, delete a note, restore
just that file from the snapshot, and find it back in the folder. 52s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Full link lifecycle in one take: share from the note menu, the warning
copy, Create Link and Copy, the public page opened in a logged-out
browser, then Settings → Shared Notes → Stop sharing until the list
reads 'No shared notes yet'. 37s.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant