chrome/LICENSE-webawesome.md
Michał Kopeć f6c8fe3d36 chrome: the shared shell, extracted from four copies
One page frame, one palette, one set of components, one implementation of
config readers, proxy auth, /healthz, i18n and cache-busted asset URLs.

The design tokens had been copied into homepage, marketplace, agent-bridge
and scribe and had started to drift; so had theme.js and the asset() helper,
which existed in two incompatible versions. board.css carried the instruction
"Copy the values from homepage's style.css when they change there", which is
the problem stated as a procedure.

Components come from Web Awesome 3.14.0 (MIT), vendored under static/wa by
vendor-webawesome.sh - curl and tar against the npm registry, so there is no
node_modules, no lockfile and nothing for CI or a Containerfile to run. The
script prunes type definitions and IDE metadata, 13M down to 3.4M, and keeps
only the en and pl translations. Components style themselves inside a shadow
root, so a page rule cannot reach into one: "this input is the wrong width"
stops being a thing that can happen rather than a thing to be careful about.

Two decisions worth recording here:

- Asset versioning is a content digest over the whole static tree, not each
  file's mtime. mtime is wrong in a container, where every COPY'd file
  carries the build timestamp, so every asset appeared to change on every
  build. A single tree-wide token also means a cached page can never pair
  itself with a newer script.
- Pages keep the data-theme="light|dark|system" attribute the services have
  always used. Web Awesome drives light/dark from a wa-light/wa-dark class
  instead; base.html and theme.js own that mapping so nothing else learns it.

The compatibility aliases in tokens.css (--bg, --surface, --accent, ...) are
deliberate: they let a service move page by page instead of all at once.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-10-04 12:34:13 +02:00

1 KiB

Copyright (c) 2025 Fonticons, Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.