Providers

Cloudimage

Nuxt Image has first class integration with Cloudimage.

Integration between Cloudimage and the image module.

To use this provider you need to specify your Cloudimage token and the baseURL of your image storage.

nuxt.config.ts
export default defineNuxtConfig({
  image: {
    cloudimage: {
      token: 'your_cloudimage_token',
      baseURL: 'origin_image_url' // or alias
    }
  }
})

Options

token

  • Type: String (required)

Your Cloudimage customer token. Register for a Cloudimage account to get one. Registration takes less than a minute and is totally free.

baseURL

  • Type: String (required)

Your origin image URL or storage alias that allows to shorten your origin image URLs.

nuxt.config.ts
export default defineNuxtConfig({
  image: {
    cloudimage: {
      token: 'demo',
      baseURL: 'sample.li'
    }
  }
})

These formats all work as well:

nuxt.config.ts
export default defineNuxtConfig({
  image: {
    cloudimage: {
      token: 'demo',
      baseURL: 'sample.li/images',
      baseURL: 'https://sample.li/images',
      baseURL: '_sl_' // alias defined in your Cloudimage storage settings
    }
  }
})

apiVersion

  • Type: String
  • Default: empty string

Allow using a specific version of the API.

For tokens created before 20.10.2021, apiVersion needs to be set to v7.

Here's an official demo config. demo is an old token hence apiVersion needs to be defined as well.

nuxt.config.ts
export default defineNuxtConfig({
  image: {
    cloudimage: {
      token: 'demo',
      baseURL: 'sample.li',
      apiVersion: 'v7'
    }
  }
})

cdnURL

  • Type: String
  • Default: https://{token}.cloudimg.io/{apiVersion}

Replaces the dynamically built URL

nuxt.config.ts
export default defineNuxtConfig({
  image: {
    cloudimage: {
      cdnURL: 'https://demo.cloudimg.io/v7',
    }
  }
})

Cloudimage modifiers

Beside the standard modifiers, also you can pass Cloudimage-specific Cloudimage-specific transformation params to modifiers prop.

Cloudimage fit values

Beside the standard values for fit property of Nuxt image and Nuxt picture, Cloudimage offers the following for extra resizing params:

  • crop - Crops the image to specified dimensions (width and height) and keeps proportions.
  • face - Crops the image automatically keeping the most prominent face.
  • fit - Resizes the image to fit into a specified width and height box, adds padding (image or solid colour) to keep proportions.
  • cropfit - Sets crop or fit resize mode depending on the origin and the desired dimensions.
  • bound - Resizes to a given width and height box and keeps proportions. Similar to fit but without adding padding.
  • boundmin - Resizes an image while bounding the smaller dimension to the desired width or height while keeping proportions.