Skip to content

docs(README): add hero video — theme-aware cover linking to the 90-second overview on YouTube #11534

Description

@yinlianghui

Self-contained spec — ready for any account/session with write access to this repo. All comments below are superseded by this body.

Goal

Surface the official 90-second overview film as the README hero visual: a theme-aware cover image that links to YouTube — the standard pattern for repos with a launch film (GitHub markdown does not render iframes, so a YouTube player cannot be embedded; a linked cover is the convention).

Video (already live): https://youtu.be/CX_FlOoOtr0 — "ObjectStack in 90 Seconds — Your Whole App, as Typed Metadata".

Steps (docs-only; no code, no changeset, no build)

  1. Add two covers to docs/screenshots/:
    • hero-cover-dark.png and hero-cover-light.png (2400×1200 brand covers, ~400KB each).
    • Source: private repo steedos-labs/video-studio, files projects/2026-08-objectstack-hero-overview/covers/cover-en-dark.png and cover-en-light.png — rename on copy. (No access to that repo? The planner has both files ready to hand over, already renamed.)
  2. Edit README.md: insert the block below immediately after the chips line (`Fits in an agent's context` · `Typed, validated, governed` · `Self-host anywhere` · Apache-2.0):
<palign="center"><ahref="https://youtu.be/CX_FlOoOtr0">
````&lt;img src="docs/screenshots/hero-cover-dark.png#gh-dark-mode-only" width="900" alt="ObjectStack in 90 Seconds — watch the overview on YouTube"&gt;````
````&lt;img src="docs/screenshots/hero-cover-light.png#gh-light-mode-only" width="900" alt="ObjectStack in 90 Seconds — watch the overview on YouTube"&gt;````
</a></p>
  1. Open a PR for maintainer review (draft → ready).

Acceptance

  • README shows the dark cover in dark mode, light cover in light mode (check both).
  • Clicking the cover opens the YouTube video.
  • No other README content changed.

Notes

  • Cover text is verbatim from the README H1 quote block — no new marketing claims.
  • Content compliance for the film itself (licensed Azure narration, platform AI disclosure) is already handled on the YouTube side.

Metadata

Metadata

Assignees

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions