Skip to content

Internal: Document site version compatibility contract - #9457

Merged
samohovets merged 1 commit into
mainfrom
codex/document-site-version-contract
Jul 22, 2026
Merged

Internal: Document site version compatibility contract#9457
samohovets merged 1 commit into
mainfrom
codex/document-site-version-contract

Conversation

@samohovets

Copy link
Copy Markdown
Member

Summary

  • document when backwards-incompatible bundle format or behavior changes require a site version increment
  • cross-reference the emitted and required site versions so they are updated together
  • clarify that the site version is separate from the Remotion package version and keep it unchanged at 11

Verification

  • bunx oxfmt packages/studio-shared/src/studio-html.ts packages/renderer/src/set-props-and-env.ts --write
  • bun run build
  • bun run stylecheck
  • git diff --check

Closes #9456

@vercel

vercel Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
bugs Ready Ready Preview, Comment Jul 22, 2026 11:15am
remotion Ready Ready Preview, Comment Jul 22, 2026 11:15am

Request Review

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ No critical issues — one rough edge in the documented contract.

Reviewed changes — add inline comments documenting when and how to bump siteVersion, and cross-reference the two files that currently hardcode '11'.

  • Document the site version compatibility contract — explain in packages/renderer/src/set-props-and-env.ts that requiredVersion should only be bumped on backwards-incompatible bundle changes, and cross-reference the emitted value in packages/studio-shared/src/studio-html.ts.
  • Mirror the note in the HTML emitter — add the same guidance above window.siteVersion = '11' in packages/studio-shared/src/studio-html.ts with a reference back to the renderer.

Pullfrog  | Fix all ➔Fix 👍s ➔View workflow run | Using Kimi K2 (free via Pullfrog for OSS) (Claude Opus not used — the program covers this model; add its provider key to run your pick) | 𝕏

timeoutInMilliseconds: actualTimeout,
});

// Increment this value when the generated bundle format or behavior changes

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// Increment this value when the generated bundle format or behavior changes
// Increment this value when the generated bundle format or behavior changes
// in a backwards-incompatible way. It is not the Remotion package version and
// should not be bumped for every generated HTML change. Keep it synchronized
// with window.siteVersion in packages/studio-shared/src/studio-html.ts and
// with packages/core/src/index.ts (which types window.siteVersion) by
// incrementing all values together.
const requiredVersion: typeof window.siteVersion = '11';

@samohovets
samohovets merged commit 4979ff2 into main Jul 22, 2026
20 checks passed
@samohovets
samohovets deleted the codex/document-site-version-contract branch July 22, 2026 11:23
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.

Repo: Document the siteVersion compatibility contract in code

1 participant