Docs
Installation
Installation
Detailed installation instructions for getting svgMagic up and running in your project.
Install the svgMagic Package
user@system path %pnpm i svgmagic
- To install svgMagic, run the installation command for the package manager of your choice in your project directory:
terminal
npm install svgmagic- Run the interactive
svgm-setupinteractive post-install script
terminal
svgm-setup- If desired, change your default directory.
- If you choose not to scaffold the sample
.svgfiles you will need to point your component into a directory with your.svgfiles. Running the script and choosing to copy the sample.svgfiles should not overwrite your existing files, unless you have matching filenames and have edited your files, in which case the samples will overwrite. - Always save your artwork outside of your project directory to back it up, or use a source manager just in case.
user@system path % svgm-setup
Project Configuration
For information on preparing your .svg file and SVG code for use with SVGM to dynamically apply CSS styles like currentColor, see Basic Styling
Ensure SVGR is Installed
SVGM uses SVGR to transform svg into React components. SVGR is a peer dependency and should be installed automatically. If not, you can install it manually:
terminal
npm install @svgr/webpackConfigure SVGR in Next.js
Add the following configuration to your next.config.js to enable SVGR:
next.config.js
module.exports = {
webpack(config) {
config.module.rules.push({
test: /.svg$/,
use: ['@svgr/webpack'],
});
return config;
},
};