waybetter/packages/shell
CRT 9606c2a86e Theme engine v3 step 5: SurfaceSet, the shell chrome reads it
themeDerive.ts: canvas, content, card, chrome, raised, panel, strong, accentFill and
tooltip, each with ink, inkSoft, link, line, hover, selected and focus solved on its
fill (both gradient ends). Hover and selected step back toward the fill until every
ink still reads on them; hover is neutral unless the theme sets one (no accent wash);
a strong gradient's end moves until one ink reads on both; targets no ink can reach
on a mid-tone fill are capped and noted. 5,000-palette property test.
chromeTheme.ts: legible() is the solver; the bevel title bar, selection and face inks
come from the strong and chrome surfaces. Chrome vars of the 13 built-ins: only the
faint/warn/danger inks move (closer to the theme colour, still 4.5:1).
2026-10-02 05:00:43 +07:00
..
scripts shell: the panel, createPanel(site) (moved from wayBetter for X) 2026-09-30 14:03:40 +07:00
src Theme engine v3 step 5: SurfaceSet, the shell chrome reads it 2026-10-02 05:00:43 +07:00
tests Store: status words follow the theme (ok/warn/danger ink tokens), with a token test 2026-10-02 04:29:27 +07:00
package.json shell: the Store view and install screen as framework React components, strings in the framework catalogs 2026-09-29 11:08:04 +07:00
README.md READMEs for strangers: overview, three layers, a real minimal adapter, security model; the long reference moves to docs/ARCHITECTURE.md 2026-09-30 23:20:58 +07:00
tsconfig.build.json shell: the panel, createPanel(site) (moved from wayBetter for X) 2026-09-30 14:03:40 +07:00

shell (internal)

Sources of waybetter/shell/*: the shell models, the Store screens, the shell frame (src/frame, createShell) and the panel (src/panel, createPanel: the app's own tab). Published as part of the waybetter package; not published on its own. The repository's docs/ARCHITECTURE.md ("The shell frame" and "The panel") describes what an app supplies.

The panel is here rather than in a package of its own because it is drawn inside the frame and shares its state: the frame's profile, deck, theme, sync and developer-mode stores, its native bridge and its language. It imports the theme document model from ../runtime by source path; the package build (packages/waybetter/scripts/build.mjs) points those imports at dist/runtime.

scripts/google-fonts-catalog.mjs regenerates the font browser's offline Google Fonts list (src/panel/fonts/googleFontsCatalog.json).