feat(tasteful-pairings): initial version

tasteful-pairings/README.md

@@ -0,0 +1,57 @@
+# Tasteful Pairings
+
+A carefully curated collection of font pairings for [Typst](https://typst.app/),
+focusing on readability and typographic harmony. Each pairing combines a
+sans-serif heading font with a serif body font, following established
+typographic principles for clear visual hierarchy and optimal reading
+experience.
+
+## Installation
+
+```typ
+#import "@preview/tasteful-pairings:0.1.0": *
+```
+
+## Usage
+
+```typ
+#let pairing = font-pairings.at("modern-heritage")
+
+#show heading: set text(font: pairing.heading)
+#set text(font: pairing.body)
+
+= Your Document Title
+Your content here...
+```
+
+## Available Pairings
+
+- **`ibm-plex`** - Modern corporate-friendly superfamily
+- **`noto`** - Extensive language support, highly legible
+- **`source`** - Adobe's refined open-source pair
+- **`friendly-weather`** - Open Fira Sans with space-efficient Merriweather
+- **`android`** - Complete Roboto family look
+- **`kindle`** - Amazon's reading-optimized fonts
+- **`office`** - Classic Microsoft Office combination
+- **`modern-heritage`** - Contemporary Montserrat with timeless Georgia Pro
+- **`legible`** - Reading-focused Lexend and Literata
+
+## Gallery
+
+![Font pairing examples gallery](thumbnail.png)
+
+## Philosophy
+
+The pairings in this collection follow these principles:
+
+1. **Sans for Headlines, Serif for Body** - Following traditional typographic
+   wisdom for clear hierarchy
+2. **Readability First** - Each pairing is tested for optimal reading experience
+3. **Complementary Characteristics** - Fonts are matched based on x-height,
+   weight balance, and character width
+4. **Practical Applications** - Selected for real-world use cases from corporate
+   documents to digital reading
+
+## License
+
+[MIT License](LICENSE).