42 lines
1.8 KiB
Markdown
42 lines
1.8 KiB
Markdown
# Web Visual Baseline — Reference Assets
|
|
|
|
The normative rules live in `contract.md`.
|
|
|
|
Canonical reference files (full, production version of the style) are in `assets/`:
|
|
|
|
- `assets/view.css` — copy this as the starting stylesheet and adapt tokens
|
|
- `assets/view.html` — reference page structure (header, panels, tables)
|
|
- `assets/upload.html` — reference upload/open panel
|
|
|
|
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.
|
|
|
|
### Icon-only buttons in table rows
|
|
|
|
```css
|
|
/* a layout rule that changes display must keep the icon centred */
|
|
.row-actions > .icon-btn { display: inline-flex; justify-content: center; align-items: center; }
|
|
/* every container that renders an icon resets fill, otherwise it is solid black */
|
|
.header-primary .icon { fill: none; stroke: currentColor; stroke-width: 2; }
|
|
/* fixed action slots keep icons in the same column on every row */
|
|
.task-actions { display: grid; grid-template-columns: repeat(3, 32px); gap: 4px; justify-content: end; }
|
|
.icon-slot { display: block; width: 32px; height: 32px; }
|
|
```
|