docs: document favicon generation; chore: add generate-favicon script and yarn task

This commit is contained in:
2025-08-16 13:22:00 -06:00
parent 7e4b13606c
commit 89a75c94ca
3 changed files with 55 additions and 0 deletions

View File

@@ -73,3 +73,17 @@ bun run preview
```
Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.
## Favicons
The SVG favicon is the source of truth: `public/favicon.svg`.
Generate a multi-size `favicon.ico` from the SVG using rsvg-convert + ImageMagick:
```bash
yarn favicons
```
Notes:
- ImageMagick on macOS can have issues loading arbitrary TTFs by file path (RenderFreetype errors). To avoid font lookup issues entirely, this project rasterizes the SVG directly using `rsvg-convert` and then packages the sizes into a single ICO using ImageMagick.
- If browsers fail to load webfonts in an external SVG, consider converting the “b” glyph to paths inside the SVG to guarantee pixel-identical rendering across formats.