Skip to content

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

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

docs: embed instructional video clips across Cloud pages#44
nellins wants to merge 14 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 8 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>
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