--- a/mrjunejune/README.md	Mon Aug 03 10:48:59 2026 -0700
+++ b/mrjunejune/README.md	Mon Aug 03 11:26:30 2026 -0700
@@ -2,6 +2,21 @@
 
 My personal website where I post my blogs / about me and resume.
 
+## WebP assets
+
+Raster source images live under `mrjunejune/assets/png/` and `assets/png/`.
+Bazel converts them to WebP before they enter the server runfiles or release
+bundle:
+
+```bash
+bazel build //mrjunejune:generated_webp_assets
+bazel build //mrjunejune:mrjunejune_server_bundle
+```
+
+The deployed site contains no PNG files. Add new PNG source assets to the
+corresponding list in `mrjunejune/BUILD` or `assets/BUILD`, then reference the
+generated `.webp` URL from the site.
+
 ## TODO 
 
 - Add caching layer