README.md — sigil-css

1# sigil-css

S-expression CSS DSL for [Sigil](https://codeberg.org/sigil/sigil). Write CSS using composable Scheme expressions instead of raw strings.

5## Usage

7```scheme

8(import (sigil css))

10;; Generate CSS from S-expressions

11(css-render

12 (css "body"

13 (background-color "#0d0d0d")

14 (color "#e8e8e8")

15 (font-family "system-ui, sans-serif"))

17 (css ".card"

18 (background "linear-gradient(180deg, #1a1a1a 0%, #141414 100%)")

19 (border "1px solid #2a2a2a")

20 (border-radius "8px")

21 (padding "1.5rem"))

23 (css ".card:hover"

24 (border-color "#d4a017")))

25```

27## Features

29- **Composable** — CSS rules are values, combine them with standard Scheme functions

30- **Themeable** — pass color values as variables, swap palettes programmatically

31- **Type-safe** — malformed CSS caught at generation time, not in the browser

32- **No build step** — generates CSS strings directly, serve inline or write to file

34## Dependencies

36- sigil-stdlib

38## Build

40```sh

41sigil deps install

42sigil build

43sigil test

44```

46## License

48BSD-3-Clause