@papit/svg-spritesheet

Merge multiple SVG files into a single SVG spritesheet using elements.

Here’s a tight, minimal README—npm-friendly and consistent with your other @papit packages:

@papit/svg-spritesheet

Merge multiple SVG files into a single SVG spritesheet using <symbol> elements.

Install

npm install @papit/svg-spritesheet

Usage

svg-spritesheet --input ./icons --output ./spritesheet.svg

Defaults:

• input: current directory
• output: <input>/spritesheet.svg
• symbol name: <title> in SVG → fallback to filename

Options

--input <dir>        SVG directory
--output <file>     Output file
--name-query <sel>  Name selector (default: title)
--info              Show progress

Output

<svg xmlns="http://www.w3.org/2000/svg">
  <symbol id="icon-name">…</symbol>
</svg>

Contributing

Contributions are welcome! Please follow the development guidelines above and ensure all tests pass before submitting a pull request.

License

Licensed under the @Papit License 1.0 - Copyright (c) 2024 Henry Pap (@onkelhoy)

Key points:

• ✅ Free to use in commercial projects
• ✅ Free to modify and distribute
• ✅ Attribution required
• ❌ Cannot resell the component itself as a standalone product

See the LICENSE file for full details.

Support

For issues, questions, or contributions, please visit the GitHub repository.