Docs/readme v0.5 cleanup

.github/workflows/swift.yml

@@ -13,12 +13,14 @@ concurrency:
 jobs:
   test:
     name: swift test (macOS)
-    runs-on: macos-14
+    runs-on: macos-15
     steps:
       - uses: actions/checkout@v4
 
-      - name: Select Xcode 15
-        run: sudo xcode-select -s /Applications/Xcode_15.4.app
+      - name: Select latest stable Xcode
+        uses: maxim-lobanov/setup-xcode@v1
+        with:
+          xcode-version: latest-stable
 
       - name: Show Swift version
         run: swift --version

README.md

@@ -8,6 +8,16 @@
 [![SwiftPM](https://img.shields.io/badge/SwiftPM-Compatible-brightgreen.svg)](https://swift.org/package-manager)
 [![License](https://img.shields.io/badge/License-MIT-lightgrey.svg)](LICENSE)
 
+<p align="center">
+  <img src="Demo/screenshots/heatmap.png" width="300" alt="Detail tab — three full-width heatmaps stacked, each in its own palette and card background">
+  &nbsp;&nbsp;
+  <img src="Demo/screenshots/heatmap2.png" width="300" alt="Boards tab — Streaks-style habit grid showing six different palettes side by side">
+</p>
+
+<p align="center">
+  <em>From a single contribution grid to a full habit-tracker UI — both screens above are built with <code>CalendarHeatmap</code>, no extra views.</em>
+</p>
+
 ## Why HeatmapKit?
 
 Most existing heatmap libraries for Apple platforms target UIKit and have not been updated for years. HeatmapKit is built **SwiftUI-first**, supports the full Apple platform family (iOS / macOS / watchOS / tvOS / visionOS), and ships modern interactions like horizontal scrolling, automatic locale-aware month labels, and tap callbacks.