Svg Sprite

SVG sprite component for Laravel Mix.
latest v2.0.0 - released
swis jazo
1171 downloads last week
MIT license
5 versions


Node Version Latest Version on NPM Code Style Software License Buy us a tree Run Status Known Vulnerabilities Made by SWIS

SVG sprite component for Laravel Mix, wrapping SVG sprite loader and SVGO loader.


Install with npm:

$ npm install --save-dev laravel-mix-svg-sprite


This component adds an extra API to Mix to create a SVG sprite of separate SVG files. It can be used just like the other API's of Mix:

// webpack.mix.js

let mix = require('laravel-mix');

    .js('src', 'output')
    .sass('src', 'output')
        'src/icons', // The directory containing your SVG files
        'output/sprite.svg', // The output path for the sprite
        [loaderOptions], // Optional, see
        [pluginOptions] // Optional, see

N.B. This component only adds a loader to the Webpack configuration, it doesn't glob your directory and include every file it finds. You need to require the icons from within your code (JS, CSS, etc.) just like other modules to have them added to the sprite!


The config of this component is passed directly to svg-sprite-loader and its plugin. Please refer to their documentation for further details. This are our defaults:

Config.svgSprite = {
     * @see
    loaderOptions: {
        extract: true
     * @see
    pluginOptions: {
        plainSprite: true

Configuration for SVGO is copied from Config.imgLoaderOptions.svgo. If you disable SVGO for the image-loader, it is also disabled for this component.

Change log

Please see CHANGELOG for more information on what has changed recently.


$ npm test


Please see CONTRIBUTING and CODE_OF_CONDUCT for details.


If you discover any security related issues, please email [email protected] instead of using the issue tracker.


This component is a wrapper for SVG sprite loader and SVGO loader, so a huge thanks to their contributors!


The MIT License (MIT). Please see License File for more information.

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

SWIS :heart: Open Source

SWIS is a web agency from Leiden, the Netherlands. We love working with open source software.