README.md — sigil-web-styles

1# sigil-web-styles

Design system and theme library for [Sigil](https://codeberg.org/sigil/sigil) web applications. Provides palettes, typography, component styles, and layouts for a consistent look across Sigil apps with customizable color themes.

5Built on top of [sigil-css](https://codeberg.org/sigil/sigil-css).

7## Usage

9```scheme

10(import (sigil web styles))

12;; Get the full stylesheet with the default black+gold theme

13(theme-stylesheet)

15;; Or customize the palette

16(theme-stylesheet palette: (make-palette

17 background: "#0a0a1a"

18 primary: "#4a90d9"

19 ...))

20```

22## Default Theme

24Black and gold with subtle gradients:

25- Background: `#0d0d0d` (near-black)

26- Surface: `#1a1a1a` (cards, panels) with subtle top-to-bottom gradient

27- Accent: `#d4a017` (gold) with gradient shine on buttons

28- Text: `#e8e8e8` (off-white)

30## Modules

32| Module | Purpose |

33|--------|---------|

34| `(sigil web styles)` | Main entry — re-exports everything |

35| `(sigil web styles palette)` | Color palettes and customization |

36| `(sigil web styles typography)` | Font stacks, type scale, weights |

37| `(sigil web styles components)` | Cards, tables, badges, buttons, nav, inputs |

38| `(sigil web styles layout)` | Page shell, grid system, responsive breakpoints |

40## Apps Using This Theme

42- [Vigil](https://codeberg.org/sigil/vigil) — service monitoring dashboard

43- [Kiln](https://codeberg.org/sigil/kiln) — CI server

44- [Folio](https://codeberg.org/sigil/folio) — task and knowledge management

45- [Live Crafter](https://codeberg.org/SystemCrafters/live-crafter) — stream management

47## Dependencies

49- sigil-css

50- sigil-stdlib

52## Build

54```sh

55sigil deps install

56sigil build

57sigil test

58```

60## License

62BSD-3-Clause