⚡ Bolt: Optimize large PNG assets using zopflipng

.jules/bolt.md

@@ -4,3 +4,6 @@
 ## 2025-12-31 - [Asset Optimization]
 **Learning:** This repository consists entirely of static assets with no build system. Performance gains come exclusively from optimizing these assets (e.g., lossless PNG compression) rather than code changes.
 **Action:** Use tools like `optipng` to reduce file sizes without quality loss. Handle filenames with spaces carefully in shell commands.
+## 2025-01-23 - [Zopflipng Superiority]
+**Learning:** `optipng` (even at `-o7`) may falsely report files as "already optimized" (e.g., `header.png`). `zopflipng` achieved an additional ~8% reduction on the same file.
+**Action:** Always prefer `zopflipng` for critical asset optimization, ignoring `optipng`'s "optimized" status if maximum compression is the goal.

README.md

@@ -22,6 +22,13 @@ https://github.com/rioforce/LEGO-Textures/issues/new
 
 NOTE: Not all requests will be granted.
 
+Performance
+===========
+
+To ensure fast download speeds and efficient storage, large PNG assets in this repository are optimized using `zopflipng`. This tool provides superior lossless compression compared to standard tools like `optipng`, often reducing file sizes by an additional 5-10% without any loss in quality.
+
+For example, `header.png` was reduced by ~8% (23KB) using `zopflipng`.
+
 License
 =======