Skip to content

docs(cli): document the image weight and heavy-image warning of flows media upload - #840

Open
teozee-adapty wants to merge 6 commits into
mainfrom
feat/heavy-image-warning
Open

teozee-adapty wants to merge 6 commits into
mainfrom
feat/heavy-image-warning

Conversation

@teozee-adapty

Copy link
Copy Markdown

Documents the image weight and the heavy-image warning of the flow image upload.

What changes

  • developer-cli-flows, adapty flows media upload: the response also has size (the weight of the sent file in bytes) and warnings; an image over 1 MB uploads with a warning (Large image — <size>, "Large images slow the first load. Upload a smaller file."); the command prints the size after the image data, then any warning, and exits with success; --json prints the full response.
  • flow-generator-skill: the skill converts a PNG or JPEG over 1 MB to WebP before the upload and says so; on the warning it names the image and its weight and offers a smaller version one step at a time, each step only after a "yes"; the weight never blocks saving or publishing.

Locales are not edited (the translation job updates them). Merge after the server and CLI changes are released.

Checks

  • MDX lint, MDX parse, internal links, unit tests, external links of the diff: pass.
  • The English build fails on main too: the prebuild copies src/api-reference/specs/* over the tracked public/api-specs/adapty-api.yaml, which is stale on main. Not caused by this change.

@teozee-adapty
teozee-adapty force-pushed the feat/heavy-image-warning branch from 871c3b2 to 4045fed Compare November 16, 2026 13:12
… media upload

The upload response of flows media upload now carries size and warnings.
The flow-generator skill page describes the WebP conversion over 1 MB and
the step-by-step image reduction on a large-image warning.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@teozee-adapty
teozee-adapty force-pushed the feat/heavy-image-warning branch from 4045fed to 331d698 Compare November 16, 2026 17:04
@teozee-adapty
teozee-adapty marked this pull request as ready for review November 18, 2026 12:09
…e 20 MiB limit, a shorter skill paragraph

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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