| 1 | # WebUI Public Assets DOX |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | - Own first-party static images, icons, splash art, and PWA assets served by the WebUI. |
| 6 | - Keep visual assets stable for core UI surfaces and settings sections. |
| 7 | |
| 8 | ## Ownership |
| 9 | |
| 10 | - SVG files own first-party icons and settings/category symbols. |
| 11 | - Raster files own splash, thumbnail, and app-icon imagery. |
| 12 | - Asset filenames are part of the frontend reference contract when used by HTML, CSS, JS, or plugins. |
| 13 | |
| 14 | ## Local Contracts |
| 15 | |
| 16 | - Do not add secrets, user uploads, generated runtime files, or private branding assets here. |
| 17 | - Keep asset paths stable or update every frontend reference in the same change. |
| 18 | - Prefer optimized web formats and reasonable file sizes for assets loaded during startup. |
| 19 | |
| 20 | ## Work Guidance |
| 21 | |
| 22 | - Use this folder for shared first-party assets, not component-specific images that belong with a plugin or component. |
| 23 | - Check contrast and legibility for icon changes in both light and dark UI contexts when relevant. |
| 24 | |
| 25 | ## Verification |
| 26 | |
| 27 | - Manually smoke-test pages that reference changed assets. |
| 28 | - Run frontend checks when asset references are covered by tests. |
| 29 | |
| 30 | ## Child DOX Index |
| 31 | |
| 32 | No child DOX files. |