--- a/hg-web/README.md	Sun Aug 02 10:07:40 2026 -0700
+++ b/hg-web/README.md	Sun Aug 02 13:51:11 2026 -0700
@@ -38,7 +38,7 @@
 │       ├── index.html
 │       ├── index.css
 │       ├── base.css
-│       └── custom pencil, panda, icon, and background assets
+│       └── custom pencil, panda, and icon assets
 ├── Build
 │   ├── BUILD
 │   ├── ../gui_ze/gui_ze.bzl
@@ -100,9 +100,14 @@
   -> GET /api/repo/file?path=...
   -> ApiGetFile
   -> GET hg-serve/raw-file/tip/<path>
-  -> highlight.js or markdown_converter WASM
+  -> highlight.js, markdown_converter WASM, or inline static preview
 ```
 
+Images, SVG, video, audio, and PDF files open in the forge preview modal.
+Unknown binary files retain a download link. The raw file API supplies explicit
+MIME types, `nosniff`, inline disposition for supported previews, and sandboxed
+SVG responses.
+
 ### Commit graph
 
 ```text