Skip to content

Update Cloudflare imageService docs for custom image service support#14095

Open
adamchal wants to merge 1 commit into
withastro:mainfrom
adamchal:docs/cloudflare-custom-image-service
Open

Update Cloudflare imageService docs for custom image service support#14095
adamchal wants to merge 1 commit into
withastro:mainfrom
adamchal:docs/cloudflare-custom-image-service

Conversation

@adamchal

Copy link
Copy Markdown

Clarify that compile mode uses a configured custom image.service when defined (running its getURL()/getHTMLAttributes() hooks during prerendering), and that custom mode now also generates optimized assets at build time via the service's transform() hook, without bundling Sharp when it is not needed.

See withastro/astro#17099.

Description (required)

Two mode descriptions were out of date:

  • compile previously always used the adapter's internal workerd image service. It now uses the configured image.service if one is defined (running its custom getURL() and getHTMLAttributes() hooks while prerendering), and falls back to the internal dependencies only when no custom service is set.
  • custom previously ran only at runtime. It now also generates optimized image assets at build time for prerendered routes (the service's transform() hook runs at build), and Sharp is no longer bundled into the worker when the configured service does not need it.

The edits keep the existing bullet structure, reuse the existing Image Options link, and preserve the existing workerd runtime caveat on custom.

Related issues & labels (optional)

Discord username: adam.chal

Clarify that `compile` mode uses a configured custom `image.service` when
defined (running its `getURL()`/`getHTMLAttributes()` hooks during prerendering),
and that `custom` mode now also generates optimized assets at build time via the
service's `transform()` hook, without bundling Sharp when it is not needed.

See withastro/astro#17099.
@astrobot-houston

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.

@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.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown

Preview deployment

✅ Deployment complete!

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