Expand text

Author: cwickham

docs/authoring/brand.qmd

@@ -451,16 +451,21 @@ $navbar-bg: $brand-blue;
 
 ### Typst
 
-Brand colors are available in `brand-color`:
+In Typst documents, brand colors are set in a [dictionary](https://typst.app/docs/reference/foundations/dictionary/) called `brand-color`. 
+You can access them directory in raw Typst blocks using the syntax `brand-color.COLOR_NAME`.
+For example, you could make a rectangle filled with your `primary` brand color:
+
+````{.markdown filename="document.qmd"}
 
-````markdown
 ```{=typst}
-#set text(fill: brand-color.primary)
+#rect(fill: brand-color.primary)
 ```
 ````
 
 ### Lua API
 
+Filters and shortcodes can access brand values using the `brand` Lua module.
+
 ``` lua
 local brand = require('modules/brand/brand')
 local primary = brand.get_color('primary')