--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/hg-web/src/icons/README.md	Tue Jan 27 06:51:44 2026 -0800
@@ -0,0 +1,29 @@
+# icons
+
+Static icon assets for the repository browser UI.
+
+## Files
+
+| File | Description | Source |
+|------|-------------|--------|
+| `folder.png` | Directory/folder icon | Flaticon |
+| `file.svg` | Generic file icon | VSCode Material Icon Theme |
+| `home.png` | Home navigation icon | Flaticon |
+| `repo.svg` | Repository icon (git branch style) | Custom |
+| `close.png` | Modal close button icon | Flaticon |
+
+## Usage
+
+Icons are served as static files at `/icons/` and referenced in `repo-browser.tsx`:
+
+```typescript
+const ICONS = {
+  folder: "/icons/folder.png",
+  file: "/icons/file.svg",
+  home: "/icons/home.png",
+  repo: "/icons/repo.svg",
+  close: "/icons/close.png"
+};
+```
+
+Add to Bazel filegroup for serving.