Document vendored SVG sprite icons and offline binary assets

This commit is contained in:
mchus committed 2026-11-01 21:13:14 +03:00
1 parent 714447aa06
commit d8dab9bab5
3 files changed
+45 -2

No files matched your search

@@ -10,3 +10,20 @@ Canonical reference files (full, production version of the style) are in `assets
Do not maintain a separate "starter" copy of the CSS anywhere; `assets/view.css` is the
single source. For a new app, copy it and delete unused rules.
## Icon workflow
Choose a named icon from [Lucide](https://lucide.dev/icons/), copy its SVG
geometry into the project's shared sprite and retain the upstream license.
Preserve the paths; give the symbol a stable application action alias.
Render the symbol through the shared icon template, for example:
```html
<button class="icon-btn" title="Download diagnostic log" aria-label="Download diagnostic log">
{{template "icon" "scroll"}}
</button>
```
The icon template emits an SVG with a local `use href="#i-scroll"` reference.
The sprite, template and CSS ship inside the binary. The browser never fetches
Lucide or another asset host. Adding an icon does not add a runtime dependency.