PHPackages                             nerdcel/kirby3-icon-sprite - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. nerdcel/kirby3-icon-sprite

ActiveKirby-plugin[Utility & Helpers](/categories/utility)

nerdcel/kirby3-icon-sprite
==========================

Kirby3 plugin to manage svg icons.

1.4.0(4mo ago)11.9kMITPHPPHP >= 8.1 < 8.5

Since Jan 26Pushed 4mo ago2 watchersCompare

[ Source](https://github.com/nerdcel/kirby3-icon-sprite)[ Packagist](https://packagist.org/packages/nerdcel/kirby3-icon-sprite)[ Docs](https://github.com/nerdcel/kirby3-icon-sprite)[ RSS](/packages/nerdcel-kirby3-icon-sprite/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (20)Used By (0)

Kirby3 plugin: Icon sprite
==========================

[](#kirby3-plugin-icon-sprite)

[![screen-icon-sprite-panel](demo.jpeg)](demo.jpeg)

This plugin provides helper functions which can be used in your template to generate a SVG sprite, to reference SVG icons in your templates and to inject SVG icons directly to the template. It also provides blueprints for the fileupload and a files section for your site.yml to manage the icons. To set custom options, please see the [Options](#options) section in this README file.

> This plugin is completely free and published under the MIT license. However, if you are using it in a commercial project and want to help me keep up with maintenance, please consider [making a donation of your choice](https://www.paypal.me/nerdcel).

Installation
------------

[](#installation)

### Download

[](#download)

Download and copy this repository to `/site/plugins/icon-sprite`.

### Git submodule

[](#git-submodule)

```
git submodule add https://github.com/nerdcel/kirby3-icon-sprite.git site/plugins/icon-sprite

```

### Composer

[](#composer)

```
composer require nerdcel/kirby3-icon-sprite

```

Setup
-----

[](#setup)

### Template

[](#template)

```

```

### Site.yml

[](#siteyml)

```
...
sections:
  svgicons: sections/svgsprite
  label: Override
  ...
```

Options
-------

[](#options)

The following options are available to be set using your site/config/config.php

```
'nerdcel.icon-sprite' => [
    'withStyles' => true,
    'fill' => '#0a0a0a',
    'width' => '24px',
    'aspectRatio' => '1'
]
```

License
-------

[](#license)

MIT

Credits
-------

[](#credits)

- [Marcel Hieke](https://github.com/nerdcel)

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance78

Regular maintenance activity

Popularity20

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~59 days

Recently: every ~91 days

Total

19

Last Release

122d ago

PHP version history (3 changes)1.0.0PHP >= 8.0 < 8.2

1.3.0-alpha-1PHP >= 8.1 < 8.4

1.4.0PHP >= 8.1 < 8.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/62cdaab427d91cc19875dc8a62e4bee3ff640b236ca5cde2ec4ca7f65fac0148?d=identicon)[nerdcel](/maintainers/nerdcel)

---

Top Contributors

[![nerdcel](https://avatars.githubusercontent.com/u/3840331?v=4)](https://github.com/nerdcel "nerdcel (27 commits)")

---

Tags

kirbykirby-pluginkirby-cmskirby3getkirby

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nerdcel-kirby3-icon-sprite/health.svg)

```
[![Health](https://phpackages.com/badges/nerdcel-kirby3-icon-sprite/health.svg)](https://phpackages.com/packages/nerdcel-kirby3-icon-sprite)
```

###  Alternatives

[belugadigital/kirby-navigation

Kirby 5 field for hierarchical menus with drag & drop level indentation.

8713.4k](/packages/belugadigital-kirby-navigation)[bnomei/kirby3-dotenv

Kirby Plugin for environment variables from .env

4144.1k1](/packages/bnomei-kirby3-dotenv)[beebmx/kirby-env

Enable env variables to Kirby

2037.9k2](/packages/beebmx-kirby-env)[bnomei/kirby3-recently-modified

Kirby Section to display recently modified content pages

309.3k](/packages/bnomei-kirby3-recently-modified)[johannschopplich/kirby-helpers

Environment, SEO, and build utilities for Kirby CMS

277.4k](/packages/johannschopplich-kirby-helpers)[moritzebeling/kirby-favicon

Kirby plugin to meet all favicon needs

144.8k](/packages/moritzebeling-kirby-favicon)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)