diff --git a/public/logos/imagekit.svg b/public/logos/imagekit.svg new file mode 100644 index 0000000000000..1387707921c94 --- /dev/null +++ b/public/logos/imagekit.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx index 8a1ceb4d90939..e4d89e9763a7d 100644 --- a/src/content/docs/en/guides/images.mdx +++ b/src/content/docs/en/guides/images.mdx @@ -541,7 +541,10 @@ Use the HTML `` element when you cannot use the `` component, for Image CDNs work with [all Astro image options](#images-in-astro-files). Use an image's full URL as the `src` attribute in the `` component, an `` tag, or in Markdown notation. For image optimization with remote images, also [configure your authorized domains or URL patterns](#authorizing-remote-images). -Alternatively, the CDN may provide its own SDKs to more easily integrate in an Astro project. For example, Cloudinary supports an [Astro SDK](https://astro.cloudinary.dev/) which allows you to easily drop in images with their `CldImage` component or a [Node.js SDK](https://cloudinary.com/documentation/node_integration) that can generate URLs to use with an `` tag in a Node.js environment. +Alternatively, the CDN may provide its own SDKs to more easily integrate in an Astro project. For example: + +- Cloudinary supports an [Astro SDK](https://astro.cloudinary.dev/) which allows you to easily drop in images with their `CldImage` component or a [Node.js SDK](https://cloudinary.com/documentation/node_integration) that can generate URLs to use with an `` tag in a Node.js environment. +- ImageKit provides an [Astro integration](https://github.com/imagekit-developer/imagekit-astro) that registers an image service, so Astro's built-in `` and `` components, along with Markdown `![]()` and MDX images, are all routed through ImageKit automatically. It adds CDN delivery, automatic AVIF/WebP conversion, responsive `srcset`, and on-the-fly transformations without changing your existing image syntax. See the full API reference for the [``](/en/reference/modules/astro-assets/#image-) and [``](/en/reference/modules/astro-assets/#picture-) components. diff --git a/src/content/docs/en/guides/media/imagekit.mdx b/src/content/docs/en/guides/media/imagekit.mdx new file mode 100644 index 0000000000000..245f704f76484 --- /dev/null +++ b/src/content/docs/en/guides/media/imagekit.mdx @@ -0,0 +1,423 @@ +--- +title: ImageKit & Astro +description: Add images and videos to your Astro project using ImageKit +sidebar: + label: ImageKit +type: media +stub: false +logo: imagekit +i18nReady: false +--- +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; + +[ImageKit](https://imagekit.io) is a real-time media optimization and delivery platform with a global CDN, a built-in Digital Asset Manager (DAM), and a URL-based transformation API for images and videos. + +When delivering through ImageKit, you get automatic format conversion (AVIF, WebP), automatic quality, responsive images, AI-powered transformations (background removal, generative fill, upscaling), and adaptive video streaming. + +## Using ImageKit in Astro + +The [ImageKit Astro SDK](https://github.com/imagekit-developer/imagekit-astro) registers a custom [image service](/en/reference/image-service-reference/) that re-routes Astro's built-in `` and `` components, plus Markdown and MDX images, through ImageKit. Local imports continue to be processed by Astro's built-in sharp service, so the integration can be added to an existing project without breaking existing assets. + +The SDK also provides a `