feat: add screenshot generation script and update README for Compose previews

Author: softartdev

.github/scripts/generate_screenshots.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PROJECT_NAME="${PROJECT_NAME:-NoteDelight}"
+PREVIEW_FILE="app/android/src/main/java/com/softartdev/notedelight/ScreenshootPreview.kt"
+OUTPUT_ROOT="$REPO_ROOT/docs/screenshoots/store"
+
+if ! command -v android >/dev/null 2>&1; then
+  echo "android CLI not found. Install it and make sure it is available on PATH." >&2
+  exit 1
+fi
+
+if ! command -v sips >/dev/null 2>&1; then
+  echo "sips not found. Screenshot dimension checks require macOS sips." >&2
+  exit 1
+fi
+
+cd "$REPO_ROOT"
+
+if [[ ! -f "$PREVIEW_FILE" ]]; then
+  echo "Preview file not found: $PREVIEW_FILE" >&2
+  exit 1
+fi
+
+STUDIO_CHECK_OUTPUT="$(android studio check)"
+if ! grep -Eq "READY[[:space:]]+$PROJECT_NAME[[:space:]]+" <<< "$STUDIO_CHECK_OUTPUT"; then
+  echo "Android Studio project '$PROJECT_NAME' is not READY." >&2
+  echo "Open this repository in Android Studio, wait for indexing, then retry." >&2
+  echo "$STUDIO_CHECK_OUTPUT" >&2
+  exit 1
+fi
+
+rm -rf "$OUTPUT_ROOT"
+
+SCREENSHOTS=(
+  "phone|light|01|notes|StorePhoneLightNotesPreview|1080|1920"
+  "phone|light|02|note-detail|StorePhoneLightNoteDetailPreview|1080|1920"
+  "phone|light|03|sign-in|StorePhoneLightSignInPreview|1080|1920"
+  "phone|light|04|security-settings|StorePhoneLightSecuritySettingsPreview|1080|1920"
+  "phone|light|05|backup-settings|StorePhoneLightBackupSettingsPreview|1080|1920"
+  "phone|dark|01|notes|StorePhoneDarkNotesPreview|1080|1920"
+  "phone|dark|02|note-detail|StorePhoneDarkNoteDetailPreview|1080|1920"
+  "phone|dark|03|sign-in|StorePhoneDarkSignInPreview|1080|1920"
+  "phone|dark|04|security-settings|StorePhoneDarkSecuritySettingsPreview|1080|1920"
+  "phone|dark|05|backup-settings|StorePhoneDarkBackupSettingsPreview|1080|1920"
+  "tablet|light|01|notes|StoreTabletLightNotesPreview|1920|1200"
+  "tablet|light|02|note-detail|StoreTabletLightNoteDetailPreview|1920|1200"
+  "tablet|light|03|sign-in|StoreTabletLightSignInPreview|1920|1200"
+  "tablet|light|04|security-settings|StoreTabletLightSecuritySettingsPreview|1920|1200"
+  "tablet|light|05|backup-settings|StoreTabletLightBackupSettingsPreview|1920|1200"
+  "tablet|dark|01|notes|StoreTabletDarkNotesPreview|1920|1200"
+  "tablet|dark|02|note-detail|StoreTabletDarkNoteDetailPreview|1920|1200"
+  "tablet|dark|03|sign-in|StoreTabletDarkSignInPreview|1920|1200"
+  "tablet|dark|04|security-settings|StoreTabletDarkSecuritySettingsPreview|1920|1200"
+  "tablet|dark|05|backup-settings|StoreTabletDarkBackupSettingsPreview|1920|1200"
+)
+
+for screenshot in "${SCREENSHOTS[@]}"; do
+  IFS="|" read -r form theme number scenario composable expected_width expected_height <<< "$screenshot"
+  output_file="$OUTPUT_ROOT/$form/$theme/$number-$scenario.png"
+  mkdir -p "$(dirname "$output_file")"
+
+  echo "Rendering $composable -> ${output_file#$REPO_ROOT/}"
+  android studio render-compose-preview \
+    --project="$PROJECT_NAME" \
+    "$PREVIEW_FILE" \
+    "$composable" \
+    --output-image-file="$output_file"
+
+  if [[ ! -s "$output_file" ]]; then
+    echo "Screenshot was not created or is empty: $output_file" >&2
+    exit 1
+  fi
+
+  actual_width="$(sips -g pixelWidth "$output_file" | awk '/pixelWidth/ {print $2}')"
+  actual_height="$(sips -g pixelHeight "$output_file" | awk '/pixelHeight/ {print $2}')"
+  if [[ "$actual_width" != "$expected_width" || "$actual_height" != "$expected_height" ]]; then
+    echo "Unexpected dimensions for $output_file: ${actual_width}x${actual_height}, expected ${expected_width}x${expected_height}" >&2
+    exit 1
+  fi
+done
+
+echo "Generated ${#SCREENSHOTS[@]} screenshots in ${OUTPUT_ROOT#$REPO_ROOT/}"

README.md

@@ -25,10 +25,16 @@ Supported platforms:
 
 ## SCREENSHOTS 🎞️
 
-<img src="docs/screenshoots/android/dark/1.png" height="447"> <img src="docs/screenshoots/ios/light/5.png" height="447"> <img src="docs/screenshoots/desktop/dark/6.png" height="447">
-<img src="docs/screenshoots/web/light/0.png" height="447">
-
-[More screenshoots…](/docs/screenshoots/screenshots.md)
+<p>
+  <img src="docs/screenshoots/store/phone/light/01-notes.png" height="447">
+  <img src="docs/screenshoots/store/phone/dark/03-sign-in.png" height="447">
+</p>
+<p>
+  <img src="docs/screenshoots/store/tablet/light/01-notes.png" width="680">
+  <img src="docs/screenshoots/store/tablet/dark/05-backup-settings.png" width="680">
+</p>
+
+[More screenshots…](/docs/screenshoots/screenshots.md)
 
 ## ARCHITECTURE 🏛
 

app/android/build.gradle.kts

@@ -87,6 +87,8 @@ dependencies {
     debugImplementation(libs.compose.ui.tooling)
     debugImplementation(libs.androidx.compose.test.manifest)
     implementation(libs.androidx.navigation.compose)
+    implementation(libs.androidx.paging.common)
+    implementation(libs.kotlinx.datetime)
     implementation(libs.material.theme.prefs)
     implementation(libs.kermit)
     implementation(libs.kermit.crashlytics)