Skip to content

docs: add opt-in image sizes below the 750px cap - #2382

Draft
deepme987 wants to merge 4 commits into
jones/image-max-widthfrom
deepme987/docs/image-size-classes
Draft

deepme987 wants to merge 4 commits into
jones/image-max-widthfrom
deepme987/docs/image-size-classes

Conversation

@deepme987

Copy link
Copy Markdown
Contributor

Summary

Stacks on #2381. That PR caps every article image at 750px, which fixes the stretched screenshots. This adds two sizes below the cap so a small screenshot can be small, without converting any markdown to HTML.

run-on.png is the case that prompted this: it is a 682x346 crop of a dropdown menu, so the 750px cap leaves it at its natural 682px and it still reads as full width. It wants 300-450px.

How it works

Mintlify has no width attribute for ![alt](src). The documented alternative is an HTML <img> with a Tailwind class, which would mean converting every image that wants a non-default size.

This selects on the file name instead, so the markdown stays markdown and sizing is one rename:

![Run on menu ...](/images/development/deploy/run-on--sm.png)
Suffix Width
--sm 400px
--md 560px
none 750px, from #2381

Two details worth knowing if anyone edits these rules:

  • *= not $=. Mintlify serves images from its CDN with a query string appended (.../run-on--sm.png?fit=max&auto=format&q=85&s=...), so an ends-with selector would never match. Confirmed against the live page.
  • The :not([data-component-part="card-image"]) is deliberate. It repeats the cap rule's exclusion so these rules win on specificity (121 vs 111) rather than on source order.

The suffix is on the file, not in the markdown, so alt text stays clean for screen readers and search. Click-to-zoom still opens the full-size image.

What changed

  • custom.css: the two rules, plus matching .frame rules so a Frame does not leave a 400px image floating in a 750px box.
  • run-on.png renamed to run-on--sm.png, with the reference updated in all five locales (en, es, ja, ko, zh).

Only that one image changes size. Everything else keeps the 750px cap.

Checked

  • The other two screenshots on that page genuinely need the full width and were left alone: run-on-custom-deployment.png is a dialog with body text, selected-deployment.jpg is a full editor window.
  • No stale /run-on.png references remain.

Selected by filename suffix so pages keep plain markdown image syntax.
Applies --sm to the Run on menu screenshot on the Cloud custom builds page.
@coderabbitai

coderabbitai Bot commented Nov 16, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

@deepme987

Copy link
Copy Markdown
Contributor Author

waiting on Mintlify for preview before getting this approved

@deepme987
deepme987 changed the base branch from jones/image-max-width to main November 16, 2026 23:04
@mintlify

mintlify Bot commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
comfy 🟢 Ready View Preview Nov 17, 2026, 12:09 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Adds --md to the Run on custom deployment dialog so the two stacked
screenshots in that Step are no longer both full width, and centres
sized images. Also matches on data-path, which carries the clean repo
path, with src kept as a fallback.
@github-actions

Copy link
Copy Markdown
Contributor

🌐 i18n translation sync check

English docs changed in this PR. 32 files in 4 languages may not be synced yet. The automated translation workflow handles these updates. Expand a language to see the files.

Japanese (ja): 8 files
  • ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx
  • ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx
  • ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx
  • ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx
  • ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
  • ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
Simplified Chinese (zh): 8 files
  • zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx
  • zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx
  • zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx
  • zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx
  • zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
  • zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
Korean (ko): 8 files
  • ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx
  • ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx
  • ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx
  • ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx
  • ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
  • ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
Spanish (es): 8 files
  • es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx
  • es/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx
  • es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx
  • es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx
  • es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
  • es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx
  • es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx

Local sync: npm run translate (see README: Automated translation)

@XXJones21
XXJones21 changed the base branch from main to jones/image-max-width November 17, 2026 01:41
@XXJones21

Copy link
Copy Markdown
Contributor

Switching from main to my branch so they can land as a stack once ready

Takes the Run on screenshot move into the Tip and repoints it at the
renamed file. Sizing only now: the display:block and margin-inline:auto
declarations are gone.

This branch was successfully deployed

1 active deployment
staging — fe82357d Deployed Nov 17, 2026 by mintlify[bot]
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.

2 participants