Asset Rebuild Recipe¶
The asset rebuild recipe regenerates all raster assets from the master SVGs. This is the authoritative update path for brand iterations.
When to run¶
Run the rebuild recipe when: - The master SVG (assets/src/logo.svg or logo-dark.svg) is updated - A new raster size is needed - Verifying that committed assets match the current SVG source
Scripts¶
| Script | Platform | Path |
|---|---|---|
| rebuild-assets.sh | POSIX (macOS/Linux) | scripts/dev/rebuild-assets.sh |
| rebuild-assets.ps1 | Windows (PowerShell) | scripts/dev/rebuild-assets.ps1 |
Requirements¶
- ImageMagick (magick or convert command)
- On Windows: winget install ImageMagick.Q16-HDRI
- On macOS: brew install imagemagick
- On Linux: apt install imagemagick
Usage¶
POSIX:
bash scripts/dev/rebuild-assets.sh
Windows:
.\scripts\dev ebuild-assets.ps1
Pass --check-only to verify the tool chain is available without regenerating assets.
Verification¶
A second run of the script after the initial generation should produce byte-identical outputs, confirming deterministic emission from the master SVGs.