Skip to content

Document Cloudflare binding build-time image optimization - #13848

Open
Daedalus-Icarus wants to merge 5 commits into
withastro:mainfrom
Daedalus-Icarus:cloudflare-binding-build-images-docs
Open

Document Cloudflare binding build-time image optimization#13848
Daedalus-Icarus wants to merge 5 commits into
withastro:mainfrom
Daedalus-Icarus:cloudflare-binding-build-images-docs

Conversation

@Daedalus-Icarus

Copy link
Copy Markdown

Changes

  • Documents the new compound imageService configuration for opting in to build-time image optimization with the Cloudflare Images binding.
  • Clarifies that imageService: 'cloudflare-binding' keeps the existing runtime-only behavior.

Related

@netlify

netlify Bot commented May 7, 2026

Copy link
Copy Markdown

Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 06e5f1a
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/69fc8e26fbf3120008e4fd65
😎 Deploy Preview https://deploy-preview-13848--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@astrobot-houston

Copy link
Copy Markdown
Contributor

Hello! Thank you for opening your first PR to Astro’s Docs! 🎉

Here’s what will happen next:

  1. Our GitHub bots will run to check your changes.
    If they spot any broken links you will see some error messages on this PR.
    Don’t hesitate to ask any questions if you’re not sure what these mean!

  2. In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳.

  3. One or more of our maintainers will take a look and may ask you to make changes.
    We try to be responsive, but don’t worry if this takes a few days.

@astrobot-houston

astrobot-houston commented May 7, 2026

Copy link
Copy Markdown
Contributor

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/guides/integrations-guide/cloudflare.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

@alexanderniebuhr alexanderniebuhr self-assigned this Jul 24, 2026
@alexanderniebuhr alexanderniebuhr added the merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!) label Jul 24, 2026

@alexanderniebuhr alexanderniebuhr left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Checked this against the implementation in withastro/astro#16194. The type signature and the opt-in/shorthand behavior descriptions match the code. One correction needed on the runtime default claim (inline suggestion below), plus two non-blocking notes.

Comment thread src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated
Comment thread src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated
Comment thread src/content/docs/en/guides/integrations-guide/cloudflare.mdx
@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown

Preview deployment

✅ Deployment complete!

@ArmandPhilippot ArmandPhilippot left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks Alex for handling this PR! I particularly appreciate this as I am not familiar with Cloudflare and every time the options change it confuses me even more. 😅

Comment thread src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated
Comment thread src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated
Comment thread src/content/docs/en/guides/integrations-guide/cloudflare.mdx
alexanderniebuhr and others added 2 commits July 30, 2026 09:43
Co-authored-by: Armand Philippot <git@armand.philippot.eu>
Co-authored-by: Armand Philippot <git@armand.philippot.eu>

@ArmandPhilippot ArmandPhilippot left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I left one last nit to simplify the type and a non-blocking question. Otherwise, it seems ready to me. Thank you both!

Comment thread src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated

export default defineConfig({
adapter: cloudflare({
imageService: { build: 'cloudflare-binding', runtime: 'cloudflare-binding' }

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I noticed we still show build and runtime here. Have you changed your mind about removing runtime? It's not a problem if that's the case, I just want to make sure it wasn't marked as resolved by mistake.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think even if it is the default value, we should still be able to configure it. Maybe the code PR needs an update here.

Co-authored-by: Armand Philippot <git@armand.philippot.eu>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants