feat: optimize Material Symbols

README.md

@@ -18,3 +18,29 @@ To get started, clone this repository and run `yarn install` in the root directo
 ### Running `scandic-web` locally
 
 To run the `scandic-web` app locally see its [README](./apps/scandic-web/README.md).
+
+## Material Symbols
+
+We download the font file from Google Fonts service and host it ourselves.
+
+### Configuration
+
+We use the following configuration:
+
+- FILL axis: 0..1
+- wght axis: 400
+- GRAD axis: 0
+- opsz axis: 24
+
+More info at https://developers.google.com/fonts/docs/material_symbols#optimize_the_icon_font
+
+### Optimization
+
+We optimize the font size by only including the icons we use in the repository.
+
+Read more at: https://developers.google.com/fonts/docs/material_symbols#use_in_web
+
+### Modifying icons
+
+1. Update the list of icons to include in `scripts/material-symbols-update.mjs`.
+2. Run `yarn run icons:update` in monorepo root.