Skip to content

docs(blob): clarify nuxt image dev config#851

Merged
atinux merged 2 commits intomainfrom
docs/blob-nuxtimg-dev-provider-none
Feb 23, 2026
Merged

docs(blob): clarify nuxt image dev config#851
atinux merged 2 commits intomainfrom
docs/blob-nuxtimg-dev-provider-none

Conversation

@onmax
Copy link
Copy Markdown
Contributor

@onmax onmax commented Feb 18, 2026

Closes #850.

Problem

In local development, @nuxt/image defaults to the ipx provider when image.provider is not configured.

When your images are served by a Nuxt route (for example /images/** via blob.serve()), IPX generates /_ipx/... URLs and then tries to read the source from the filesystem, not by requesting your /images/** route. This leads to IPX_FILE_NOT_FOUND.

Minimal repro (Nuxt 4.3.1, @nuxt/[email protected], @nuxthub/[email protected]):

  • Blob route returns 200:
    • curl -i http://127.0.0.1:3000/images/photo.png
  • NuxtImg + default IPX fails:
    • curl -i 'http://127.0.0.1:3000/_ipx/w_300&q_80/images/photo.png' -> 404 IPX_FILE_NOT_FOUND
  • Setting image: { provider: 'none' } makes <NuxtImg> pass-through and use /images/... URLs -> works.

Local evidence captured:

  • baseline (IPX): /tmp/nuxthub-850-baseline.png
  • fixed (none): /tmp/nuxthub-850-fixed.png

Changes

  • Add an explicit /images/** blob.serve() route snippet to the Nuxt Image section and link to the full "Serve a blob" docs.
  • Recommend image: { provider: 'none' } for development/default config.
  • Keep platform providers (Cloudflare/Vercel) in $production only.
  • Remove cloudflare.baseURL: '/images' from the example.
  • Fix the "Serve a blob" snippet to include the missing imports/param handling.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages bot commented Feb 18, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
playground 2a30086 Commit Preview URL

Branch Preview URL
Feb 18 2026, 11:38 AM

@vercel
Copy link
Copy Markdown

vercel bot commented Feb 18, 2026

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

Project Deployment Actions Updated (UTC)
nuxthub Ready Ready Preview Feb 18, 2026 11:39am

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new bot commented Feb 18, 2026

npm i https://pkg.pr.new/@nuxthub/core@851

commit: 2a30086

@atinux atinux merged commit c8ebf42 into main Feb 23, 2026
10 checks passed
@atinux atinux deleted the docs/blob-nuxtimg-dev-provider-none branch February 23, 2026 17:31
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.

NuxtImg integration with Blob storage

2 participants