--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/hg-web/src/README.md	Tue Jan 27 06:51:44 2026 -0800
@@ -0,0 +1,30 @@
+# src
+
+Frontend source files for the Mercurial repository browser.
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `repo-browser.tsx` | Main React component for the repository browser UI |
+| `main.tsx` | React entry point, renders RepoBrowser |
+| `index.html` | HTML template |
+| `index.js` | JavaScript entry point |
+| `index.css` | highlight.js theme styles |
+| `base.css` | Base/reset styles |
+| `build.ts` | esbuild configuration for bundling |
+
+## Components (repo-browser.tsx)
+
+- `RepoBrowser` - Main app component with routing and state
+- `FileList` - Renders directory listing
+- `FileRow` - Individual file/folder row with prefetch on hover
+- `FileViewer` - Modal for viewing code files with syntax highlighting
+- `MarkdownViewerModal` - Modal for rendered markdown files
+- `ReadmeViewer` - Inline README.md display
+- `Breadcrumb` - Navigation breadcrumb
+- `GlobalStyles` - CSS-in-JS with dark/light theme support
+
+## Subdirectories
+
+- `icons/` - Static icon assets