PHPackages                             eminos/statamic-favicons - 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. eminos/statamic-favicons

ActiveStatamic-addon[Utility & Helpers](/categories/utility)

eminos/statamic-favicons
========================

Optional Statamic tag for rendering favicon markup generated by statamic-favicons.

v1.0.0(2mo ago)01MITPHPPHP ^8.3

Since May 25Pushed 2mo agoCompare

[ Source](https://github.com/eminos/statamic-favicons-addon)[ Packagist](https://packagist.org/packages/eminos/statamic-favicons)[ Docs](https://github.com/eminos/statamic-favicons-addon)[ RSS](/packages/eminos-statamic-favicons/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

Statamic Favicons
=================

[](#statamic-favicons)

A tiny Statamic favicon add-on for projects that use the `statamic-favicons` generator. The generator is a simple CLI that creates a complete favicon set in a few seconds from one source image. It auto-detects a Statamic project, finds likely source icons, previews them in the terminal, suggests Tailwind theme colors, detects common Antlers partial and layout conventions, writes the generated assets, and can create an Antlers partial for your layout.

The primary workflow is still the NPX generator:

```
npx statamic-favicons generate
```

That command generates the favicon assets, manifest metadata, Antlers partial, and JSON data directly in your Statamic project. This add-on is optional. It exists as a small Statamic-native convenience layer for teams that prefer a tag in their layout.

Related links:

- NPX generator:
- Generator source:

CLI Preview
-----------

[](#cli-preview)

The generator is wizard-first. A typical run looks like this:

```
$ npx statamic-favicons generate

Statamic Favicons

Detected
Project: /sites/example
Sources found: 2
Layouts found: 1
Theme colors found: 3
App name: Example Site

Source preview
resources/images/favicon.svg

? Select source favicon
  resources/images/favicon.svg

? Use resources/images/favicon.svg?
  Yes

? Assets output directory
  public/assets/favicons

? Where should the Antlers partial be written?
  resources/views/partials/favicons.antlers.html
  Hint: detected Statamic partial convention

? Public path for generated tags
  /assets/favicons/

? Website name
  Example Site

? Short website name
  Example

? Browser theme color
  brand: #ff6633
  Hint: detected from Tailwind theme colors

? Manifest background color
  white: #ffffff
  Hint: detected from Tailwind theme colors

? Icon background color
  transparent
  Hint: keep source image transparency

? Generate favicon assets and partial?
  Yes

Generated
public/assets/favicons/favicon.ico
public/assets/favicons/favicon.svg
public/assets/favicons/favicon-96x96.png
public/assets/favicons/apple-touch-icon.png
public/assets/favicons/site.webmanifest
resources/views/partials/favicons.antlers.html
resources/favicons.json

```

What This Add-on Does
---------------------

[](#what-this-add-on-does)

It adds one Antlers tag:

```
{{ favicons }}
```

The tag renders favicon markup from the files generated by the NPX package:

1. `resources/views/partials/favicons.antlers.html`
2. `resources/favicons.json`

If neither file exists, the tag renders nothing in production. In local debug mode it can output a short HTML comment reminding you to run the generator.

When To Use It
--------------

[](#when-to-use-it)

Use the generator only if you want the simplest setup:

```
{{ partial:partials/favicons }}
```

Install this add-on if you prefer this instead:

```
{{ favicons }}
```

That is intentionally the whole feature. The generator does the real favicon work; the add-on only gives Statamic a clean runtime hook for the generated output.

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

[](#installation)

```
composer require eminos/statamic-favicons
```

Then generate your favicons from the Statamic project root:

```
npx statamic-favicons generate
```

Add the tag inside your layout ``:

```
{{ favicons }}
```

Configuration
-------------

[](#configuration)

Publishing the config is optional:

```
php artisan vendor:publish --tag=statamic-favicons-config
```

The defaults are:

```
return [
    'partial' => resource_path('views/partials/favicons.antlers.html'),
    'data' => resource_path('favicons.json'),
    'debug_missing_comment' => true,
];
```

Development
-----------

[](#development)

```
composer install
composer test
```

License
-------

[](#license)

MIT

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance88

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

60d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5f7b9b5acefc797c0c0cf24b4b05ce1f55e50a0c20e5bdbf647eae53b0a16fab?d=identicon)[eminos](/maintainers/eminos)

---

Top Contributors

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

---

Tags

faviconaddonstatamicfaviconsbrowser appearance

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/eminos-statamic-favicons/health.svg)

```
[![Health](https://phpackages.com/badges/eminos-statamic-favicons/health.svg)](https://phpackages.com/packages/eminos-statamic-favicons)
```

###  Alternatives

[statamic/seo-pro

68516.6k](/packages/statamic-seo-pro)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

23111.5k15](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo

Save time and get your Statamic site to rank better with the SEO addon for Statamic.

15133.0k](/packages/withcandour-aardvark-seo)[visuellverstehen/statamic-classify

A useful helper to add CSS classes to all HTML tags generated by the bard editor.

20121.5k](/packages/visuellverstehen-statamic-classify)[justkidding96/aardvark-seo

Save time and get your Statamic site to rank better with the SEO addon for Statamic.

155.4k](/packages/justkidding96-aardvark-seo)[aerni/livewire-forms

A Statamic forms framework powered by Laravel Livewire

2915.1k](/packages/aerni-livewire-forms)

PHPackages © 2026

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