394a252f9e
- 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.
130 lines
4.5 KiB
Markdown
130 lines
4.5 KiB
Markdown
# 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:
|
||
1. Use Varela Round for all text
|
||
2. Set base font size to 14px (12px for secondary)
|
||
3. Use spacing scale (4px units: 4, 8, 12, 16, 20)
|
||
4. Use border radius from this system (8px default, 6px secondary)
|
||
5. Leverage pywal colors for dynamic theming
|
||
6. Keep margins/padding consistent across similar components
|