Commit9e90d124Recorded29 Mar 2026Repositorysigil-css

Add README

Changed
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
Diff
README.mdadded
@@ -0,0 +1,47 @@
+1
# sigil-css
+2
+3
S-expression CSS DSL for [Sigil](https://codeberg.org/sigil/sigil). Write CSS using composable Scheme expressions instead of raw strings.
+4
+5
## Usage
+6
+7
```scheme
+8
(import (sigil css))
+9
+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"))
+16
+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"))
+22
+23
(css ".card:hover"
+24
(border-color "#d4a017")))
+25
```
+26
+27
## Features
+28
+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
+33
+34
## Dependencies
+35
+36
- sigil-stdlib
+37
+38
## Build
+39
+40
```sh
+41
sigil build sigil-css
+42
sigil test
+43
```
+44
+45
## License
+46
+47
BSD-3-Clause