Breadway 394a252f9e Fix audit findings: bakery index signing, artifact checksums, stale theme docs

- Add minisign-based signing/verification for the bakery index:
  scripts/gen-index.sh signs index.json (MINISIGN_SEC_KEY env var, dormant
  no-op with a loud warning until a key is provisioned); bakery/src/manifest.rs
  fetches index.json.minisig and verifies it with minisign-verify against a
  hardcoded PUBKEY before parsing/caching, and re-verifies the cached copy
  on every load (falls back to one re-fetch if the cache predates signing
  or fails verification; a fresh fetch that fails verification is a hard
  error).
- Close the previously-unchecksummed config-example and systemd-unit
  downloads in bakery/src/install.rs (scaffold_config, install_service):
  index.json now carries `sha256`/`example_sha256` for these artifacts
  (computed in gen-index.sh), verified via the same download::verify_sha256
  used for binaries. Downloads without a matching sha256 in the index are
  refused rather than installed unverified.
- scripts/get.sh now verifies the bakery release binary itself against a
  pinned minisign public key before installing it (falls back to the
  existing sha256-only check with a loud warning if no .minisig is
  published yet or minisign isn't installed; a present-but-invalid
  signature is a hard failure).
- Add dormant "sign release binary" steps to the bakery and bread-theme
  release workflows (.github/workflows/release.yml,
  .forgejo/workflows/release-bread-theme.yml), gated on secrets that are
  not yet configured — binaries ship unsigned exactly as before until the
  owner wires up the secret.
- .gitignore: add *.minisign-sec / minisign.key so the signing key can
  never be committed by accident.
- bread-theme: fix stale docs describing a "Catppuccin Mocha fallback"
  (BREAD_DESIGN_SYSTEM.md, README.md, Cargo.toml/bakery.toml/registry
  descriptions) — the actual implementation (palette.rs) uses a fixed BOS
  dark base with only accent colors from pywal.
- bread-theme: fix the legacy css_vars() path, which had its own
  hand-written @define-color block that predated the `accent` and computed
  `on-*` ink colors used by the rest of the stylesheet — any caller whose
  CSS referenced those names against css_vars()'s output would hit
  undefined colors (the illegible-text bug). css_vars() now delegates to
  the same define_colors() the full stylesheet uses, so the two can't
  drift apart again.

2026-07-17 03:37:51 +08:00

4.5 KiB

Raw Blame History

Bread Design System

Unified visual identity for breadbar, breadbox, breadpad/breadman, and bos-settings.

Architecture (single source of truth)

The tokens below are implemented once in the bread-theme crate as stylesheet(&Palette) — the full component stylesheet (buttons, entries, switches, lists/rows/sidebars, cards, chips, scrollbars, headings) over a canonical @define-color palette (surface=color0, overlay=color7, accent=color4).

The bread-theme CLI renders it from the live pywal palette to $XDG_RUNTIME_DIR/bread/theme.css (run at login and from a pywal hook).
Every GUI loads that file via bread_theme::gtk::apply_shared() and live-reloads it, then layers on only its own app-specific rules.

Result: one definition, no per-app drift, and palette changes recolour the whole desktop with no rebuilds. Apps reference the shared @define-color names rather than raw palette slots.

Typography

Font Family: Varela Round, sans-serif
Base Size: 14px
Secondary: 12px (metadata, helper text, secondary labels)
Font Weight: Normal (400) for body, Bold (700) for emphasis

Spacing Scale (4px units)

Use these values consistently across all projects:

xs: 4px (small gaps, internal padding)
sm: 8px (default spacing between elements)
md: 12px (medium spacing, main padding)
lg: 16px (large padding, major spacing)
xl: 20px (extra large spacing, section breaks)

Border Radius

Establish a visual hierarchy with consistent rounding:

Primary (buttons, cards, main containers): 8px
Secondary (input fields, chips, entries): 6px
Tertiary (small interactive elements): 4px
Pill (fully rounded buttons, badges): 999px

Color System

All projects use pywal dynamic theming for accents, layered on a fixed BOS dark base — background, surface, overlay, and foreground never come from pywal, only the accent slots (color1–6) track the current wallpaper:

Background: #0c0c0c (fixed)
Foreground: #e8e8e8 (fixed)
Surface: #1a1a1a (fixed, color0)
Overlay: #d8d8d8 (fixed, color7)
Accent: Dynamic (from pywal color4), with curated bread-toned defaults before any wallpaper has been set

Without pinning bg/surface/overlay, a light or muddy-toned wallpaper makes pywal hand back a light or off-hue background, and every bread GUI's panels inherit it — see bread-theme/src/palette.rs for the implementation.

Color palette slots (via wal):

color0–color7: ANSI colors (0 and 7 fixed, 1–6 pywal-derived)
Semantic: red, green, yellow, blue, pink, teal
Computed ink: on-bg, on-surface, on-accent, on-red, on-overlay — black or white text, whichever is legible against that background (see bread_theme::ink_on)

Component Standards

Buttons

Border Radius: 8px
Padding: 8px 16px (primary), 4px 8px (secondary)
Font Size: 14px
Background: Theme accent color

Input Fields

Border Radius: 6px
Padding: 12px 16px
Font Size: 14px
Border: 1px or 2px solid (blue on focus)

Cards

Border Radius: 8px
Padding: 12px
Margin: 8px
Box Shadow: Optional, for depth

Stat Labels

Font Size: 14px
Margin Right (between icon/text): 5px
Group Margin Right: 12px

Notification Cards

Border Radius: 8px
Padding: 12px
Margin Bottom: 8px
Font Size: 14px (summary), 12px (body)

Current Implementation

All GUI apps load bread_theme::stylesheet (via the generated shared file) and add only app-specific rules:

breadbar — shared base + bar window, workspace buttons, stats, notification and OSD cards.
breadbox — shared base + launcher panel, search entry, result rows.
breadpad / breadman — shared base + capture popup, type chips, note cards, reminder window, sidebar rows.
bos-settings — shared base + content padding only (was previously a hardcoded Nord palette; migrated to the shared stylesheet).
breadcrumbs — CLI tool; ANSI colours only, no GUI styling.

Palette note: background/surface/overlay/foreground are a fixed BOS dark base, never pywal-derived; only the accent slots (color1–6) track the current wallpaper via pywal.

Future Consistency Checks

When adding new components or updating existing ones:

Use Varela Round for all text
Set base font size to 14px (12px for secondary)
Use spacing scale (4px units: 4, 8, 12, 16, 20)
Use border radius from this system (8px default, 6px secondary)
Leverage pywal colors for dynamic theming
Keep margins/padding consistent across similar components

4.5 KiB Raw Blame History Unescape Escape