Skip to content

fix: use vercel image provider for production deployment#82

Merged
Joehoel merged 1 commit intomasterfrom
fix/use-vercel-image-provider
Jan 25, 2026
Merged

fix: use vercel image provider for production deployment#82
Joehoel merged 1 commit intomasterfrom
fix/use-vercel-image-provider

Conversation

@Joehoel
Copy link
Copy Markdown
Owner

@Joehoel Joehoel commented Jan 25, 2026

Problem

Images are not loading on the production site at joelkuijper.me.

Root Cause

The site uses @nuxt/image with the ipx provider, but it's deployed on Vercel with prerendering enabled (routeRules: '/**': { prerender: true }).

The IPX provider doesn't work correctly with this setup because:

  • IPX requires server-side processing to handle /_ipx/ image transformation routes
  • With prerendering, pages are statically generated at build time
  • The prerendered pages reference /_ipx/ URLs that don't exist in the static output

Solution

Switch to Vercel's native image provider (provider: 'vercel') which:

  • Uses Vercel's CDN for on-demand image optimization
  • Works correctly with prerendered/static pages
  • Is automatically detected on Vercel deployments (when not overridden by an explicit provider setting)

Changes

  • nuxt.config.ts: Changed image.provider from 'ipx' to 'vercel'

Testing

After merging, deploy to Vercel and verify images load correctly on:

  • Blog post cover images (e.g., posts with coverImage set)

The IPX image provider doesn't work correctly with prerendering on Vercel
because IPX requires server-side processing to handle /_ipx/ routes. When
the site is prerendered, these routes don't exist, causing images to fail.

Switch to Vercel's native image provider which uses Vercel's CDN for
on-demand image optimization, working correctly with prerendered pages.
@Joehoel Joehoel merged commit 2dc8601 into master Jan 25, 2026
1 of 2 checks passed
@Joehoel Joehoel deleted the fix/use-vercel-image-provider branch January 25, 2026 20:42
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.

1 participant