Skip to content
Image (pre)processing with Sharp for Svelte
JavaScript TypeScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
dev dependencies, reversed srcset Nov 1, 2019
node-scripts Add Changelog tooling Sep 1, 2019
src class, placeholderClass, wrapperClass, lazy props Dec 28, 2019
test Tidy up codebase Oct 29, 2019
.gitignore Add tests Oct 29, 2019 Bump to v0.1.10-pre Dec 28, 2019 class, placeholderClass, wrapperClass, lazy props Dec 28, 2019
jest.config.js Add tests Oct 29, 2019
package.json Bump to v0.1.10-pre Dec 28, 2019
yarn.lock upgrade sharp Dec 28, 2019

Svelte image


Svelte image is a preprocessor which automates image optimization using sharp.

It parses your img tags, optimizes or inlines them and replaces src accordingly. (External images are not optimized.)

Image component enables lazyloading and serving multiple sizes via srcset.

This package is heavily inspired by gatsby image.


yarn add svelte-image

In your rollup.config.js add image to preprocess section:

import image from "svelte-image";

  preprocess: {

And have fun!

  import Image from "svelte-image";

<Image src="fuji.jpg">

Will generate

  sizes="(max-width: 1000px) 100vw, 1000px"
  srcset="g/400-fuji.jpg 375w, g/800-fuji.jpg 768w, g/1200-fuji.jpg 1024w"

Image path

Please note that the library works only with relative paths in Sapper at the moment. <Image src="images/fuji.jpg"> works whereas <Image src="/images/fuji.jpg"> doesn't.

Configuration and defaults

Image accepts following configuration object:

const defaults = {
  optimizeAll: true, // optimize all images discovered in img tags
  // Case insensitive. Only files whose extension exist in this array will be
  // processed by the <img> tag (assuming `optimizeAll` above is true). Empty
  // the array to allow all extensions to be processed. However, only jpegs and
  // pngs are explicitly supported.
  imgTagExtensions: ['jpg', 'jpeg', 'png'],
  // Same as the above, except that this array applies to the Image Component.
  // If the images passed to your image component are unknown, it might be a
  // good idea to populate this array.
  componentExtensions: [],
  inlineBelow: 10000, // inline all images in img tags below 10kb

  compressionLevel: 8, // png quality level
  quality: 70, // jpeg/webp quality level
  tagName: "Image", // default component name
  sizes: [400, 800, 1200], // array of sizes for srcset in pixels
  // array of screen size breakpoints at which sizes above will be applied
  breakpoints: [375, 768, 1024],
  outputDir: "g/",
  placeholder: "trace", // or "blur",
  // WebP options [sharp docs](
  webpOptions: {
    quality: 75,
    lossless: false,
    force: true
  webp: true,
  // Potrace options for SVG placeholder
  trace: {
    background: "#fff",
    color: "#002fa7",
    threshold: 120

Image component props

Standard image tag props.

  • class default: ""

  • alt default: ""

  • width default: ""

  • height default: ""

  • c default: "" Class string // deprecated in favor of class

  • wrapperClass default: "" Classes passed to Waypoint wrapper

  • placeholderClass default: "" Classes passed to placeholder

  • threshold default: 1.0 "A threshold of 1.0 means that when 100% of the target is visible within the element specified by the root option, the callback is invoked."

  • lazy default: true Disables Waypoint.

Following props are filled by preprocessor:

  • src default: ""
  • srcset default: ""
  • srcsetWebp default: ""
  • ratio default: "100%"
  • blur default: false
  • sizes default: "(max-width: 1000px) 100vw, 1000px"


  • Generate and add responsive images
  • Set base64 placeholder
  • Optimize normal images using img tag
  • Image lazy loading
  • Optional SVG trace placeholder
  • Support WebP
  • Optimize background or whatever images found in CSS
  • Resolve imported images (only works with string pathnames at the moment)


Run yarn && yarn dev in the /dev directory. This is the source code of demo homepage.


You can test the preprocessor via yarn test. We are using Jest for that, so you can also pass a --watch flag to test while developing.

Currently, the best way to test the Svelte component is by using it in a separate project and using yarn/npm link. The dev directory tends to have issues keeping in sync with changes to the src in the root of the repo.

You can’t perform that action at this time.