Changelog — Hymns for Worship

v2026.10.18

Latest Release

Automated release updates.

v2026.10.17

Traffic-Light Hymn Access Status Indicators (Lyrics → View → Export): Replaced the generic share-button access icon in hymn lists with a 3-tier traffic-light status system (Lyrics with document icon & theme-harmonized Rose/Coral, View with eye icon & theme-harmonized Amber/Gold, and Export with document-download icon & theme-harmonized Emerald Green), keeping catalog and list rows as compact icon-only badges while displaying the short tier label (Lyrics, View, Export) alongside the icon on Hymn Details and the Access Breakdown header across iOS, iPadOS, macOS, and Android.
Store Metadata & Asset Best Practices CI (2026 Standards): Added a unified metadata/ directory containing complete store listings, Google Play Data Safety declarations, Apple Privacy Manifest and Nutrition Label disclosures, StoreKit 2/RevenueCat subscription configurations, and EU DSA compliance filings, updated native screenshot generation to include the mandatory iPhone Dynamic Island medium display resolution (1179 × 2556 px), and upgraded the screenshots CI workflow (.gitea/workflows/screenshots.yml) with automated zero-alpha checks, 8 MB file size limits, and multi-device dimension verifications.

v2026.10.16

Instant Mobile Web List Sync & Direct Cloud Write-Through: Added a fast server-assisted user_data bucket sync endpoint (GET /v1/users/me/lists-sync) that streams only the signed-in user's 3#user_data PowerSync bucket (skipping the 41 MB library_data catalog stream) and enriches list items from the server's in-memory catalog in ~130ms, added direct HTTP write-through to /api/powersync-upload for all list and list-item mutations so edits persist immediately across mobile MPA page navigations even before WASM SQLite finishes initializing, and added server-backed catalog search and portion lookup fallbacks (GET /v1/catalog/lookup).
Zero-Flash Web Hymn Lists & Sync Stability: Eliminated hymn list, list item, and hymn-detail containing-list flashing during background PowerSync checkpoints across iOS Safari, Android Chrome, Samsung Internet, Firefox, and desktop browsers by persisting local list/item snapshots (hfw_cached_user_lists_v2, hfw_cached_list_items_v2) with full portions and nullable metadata fidelity, debouncing SQLite watch streams, deduplicating status ticks, and comparing list/item snapshots structurally before re-rendering.
Self-Healing Cloud Sync & Safe One-Tap Cache Recovery: Added automatic PocketBase JWT refresh and retry on HTTP 401/403 inside HttpPowerSyncConnector (fetchCredentials and uploadData), a poisoned CRUD row circuit breaker, automatic migration of both local_guest lists and list items (user_lists, user_list_items, and pending ps_crud entries) to the signed-in user, browser lifecycle (visibilitychange, pageshow bfcache, online) sync resumption, and one-tap Sync Now / Repair Sync & Clear Stale Cache controls that preserve pending offline list edits so users never need to clear browser data or re-sign in manually.
PWA Service Worker, Custom List Slide Presentation & Mobile Responsiveness: Added a versioned PWA Service Worker (/sw.js) with automatic old-cache cleanup, strict no-store cache headers on .dart.js, powersync_db.worker.js, sqlite3.wasm, and manifest.json, PWA home-screen quick shortcuts, custom list-item stanza selection (customParts) in live slide presentation, Screen Wake Lock (navigator.wakeLock) during hymn presentation, top-layer <output popover="manual"> toast notifications, and mobile viewport/safe-area/input-zoom refinements.

v2026.10.15

Automated release updates.

v2026.10.14

Automated release updates.

v2026.10.13

Hymn List Fast-Scroll & Thumbnail Performance (iOS & Android): Eliminated main-thread synchronous file checks and full-resolution image decompression during hymn list scrolling by indexing downloaded title slides in memory (O(1) lookup), adding a 25ms fast-scroll settle debounce on off-screen rows, and downsampling thumbnails on background threads via ImageIO (CGImageSourceCreateThumbnailAtIndex) on iOS and BitmapFactory on Android.
List Details Hymn Item Editor Enhancements (iOS & Android): Added a Change Hymn picker (search by hymn number or title) and a Reset to Default Parts Order button to the hymn item edit sheet on List Details across both iOS and Android.
Smooth Present Mode Slide Transitions (iOS & Android): Pre-decoded and pre-warmed neighboring slide bitmaps in the background (HfwSlideStageImageView on iOS and hfwPrewarmSlideBitmaps on Android), added sequence-hashed slide caching for custom list part sequences, and pre-warmed combined list presentations automatically when opening or editing a list.
iOS Sheet Music Pinch-to-Zoom & 2D Panning: Replaced the SwiftUI MagnificationGesture branch-swapping view with a hardware-accelerated UIKit UIScrollView (HfwZoomScrollView) supporting smooth focal-point pinch-to-zoom (1.0x–4.0x), double-tap zoom at the tap point, 2D panning, and automatic coordination with multi-page swipe navigation.
Web Custom Lists Loading & Sync Reliability: Fixed custom hymn lists and list items not loading on the web when hfw_user_id is missing from localStorage or while PowerSync is initializing/syncing in the background, added JWT user ID recovery, eliminated duplicate PowerSync reconnect races on startup, and added a PocketBase REST API fallback with bounded query timeouts.
iOS Floating Bottom Search Bar & Tap Target Handling: Restored the floating glass bottom search and filter bar over scrolling lists on iOS while preserving reliable UIKit tap handling for the filter, clear search, and add-list buttons.
Mobile Cold-Start Initialization Fix: Resolved a cold-start initialization race condition and premature 0 Results state before the local catalog database finishes opening.

v2026.10.12

Native iOS & iPadOS App (SwiftUI + iOS 26 Liquid Glass): Rebuilt the iOS and iPadOS user interface in 100% native SwiftUI using iOS 26 Liquid Glass APIs (glassEffect, GlassEffectContainer, role-based Search tab, floating glass capsules, native Form grouped Profile settings, and TabViewBottomAccessory mini-player).
Native Android App (Jetpack Compose + Material 3 Expressive): Rebuilt the Android user interface in 100% native Jetpack Compose with Material 3 Expressive (MaterialExpressiveTheme, MotionScheme.expressive() spring physics, dynamic color support, segmented connected controls, and expressive tonal surfaces).
Headless Flutter Shared Engine & Pigeon Bridge: Unified business logic, offline-first SQLite + PowerSync sync, authentication, RevenueCat subscriptions, and audio playback in a headless Flutter engine connected via a type-safe Pigeon bridge (hfw_native_bridge.dart).
Adaptive Tablet & iPadOS Layouts: Added multi-column split-view navigation (NavigationSplitView on iPadOS, dual-pane adaptive rail + detail view on Android tablets/foldables), hardware keyboard shortcuts (⌘1–⌘4, ⌘F, Space), hover effects, and context menus.
Automated Multi-Layer Test Suites & Test Track Readiness: Added Dart bridge unit tests, Android JVM & Compose UI instrumentation tests, iOS XCTest suites, Android adaptive launcher icons, and updated App Store Connect / TestFlight & Google Play metadata.

v2026.10.10

Automated release updates.

v2026.9.16

Automated release updates.

v2026.9.14

Automated release updates.

v2026.9.12

Live List Sync Updates: Fixed PowerSync database connection reconnect loop and stream queries so user lists stream updates live in real time on web.
Google Play Developer API Deployment: Upgraded Android deployment to use native Google Play Developer API (Android Publisher v3) for automated publishing to internal testing track.
Android 16 Target SDK Upgrade: Updated Android target SDK to API 36 compliance.

v2026.9.11

Automated release updates.

v2026.9.10

Automated release updates.

v2026.9.9

Automated release updates.

v2026.9.5

Calendar Versioning Migration: Migrated versioning scheme from Semantic Versioning (5.8.0) to Calendar Versioning (YYYY.M.D+build, 2026.9.5) to align release cadences with slides-for-worship.
Automated Multi-Platform CI/CD: Added complete automated CI/CD pipelines for Web (Jaspr, WASM, Docker), Android (AAB, APK, Google Play), and iOS (IPA, TestFlight) with smart change-detection gating and Cloudflare R2 distribution.

v5.8.0

Google Play Compliance: Updated Android target SDK to API 35 (Android 15) and upgraded the Google Play Billing Library to v8 via RevenueCat (purchases_flutter 10.11.0). Enabled Android 14+ predictive back gestures.
Profile Hymn Folders: Segmented access permissions under Profile into separate folders (Purchased, View Only, Export Ready) based on your active subscriptions and WooCommerce purchases.
New List Creation Screen: Switched list creation from modal dialog popups to a clean, dedicated full details screen.
Nested Directory Creation: Added inline list creation shortcuts directly inside the sidebar tree explorer and middle folder details views. When creating a list from inside a subfolder, the folder path prefix is automatically pre-filled.

v5.7.0

Music Notation Browsing: Added a new Notation folder under Library to browse hymns by time signature, key signature, pitch direction, starting beat, and pitch.
Mixed Time Signature Splitting: Automatically split complex time signatures to place hymns inside all matching plain time signature subfolders.
Index Subfolders: Grouped Key/Time Index hymns by Key and meter, and Scripture Index hymns by book and chapter.
Natural Alphanumeric Sorting: Implemented natural sorting (naturalCompare) for all explorer folders and lists so numbered prefixes (e.g. Chapter 2 vs Chapter 10) sort in correct numerical order by default.
Case-Insensitive Database Match Fix: Fixed an issue where first line lyric matches were not displaying due to a case-sensitivity discrepancy in SQLite database portion name comparisons.

v5.6.0

Nested User List Folders: Added support for grouping user lists into directories using path separators (e.g., Folder/Subfolder/Name).
Sidebar Directory Tree: Added a hierarchical folder browser tree inside the collapsible sidebar navigation. Clicking a folder opens its contents in the lists screen, and clicking only the arrow expands/collapses the directory tree.
Auto-Sync and Clean Names: Implemented folder renaming and deleting actions with automatic recursive updates across all child lists. Emojis, symbols, and punctuation are automatically stripped from web export filenames.
Marquee Descriptions: Enforced single-line constraints for list descriptions; long descriptions now display with a smooth scrolling marquee instead of wrapping into multiple lines.
HTML Stripping: Automatically strip raw HTML tags from list descriptions in UI views and editor fields.

v5.5.8

Safe Export Filenames: Added robust filename sanitization when exporting lists to PPTX, ZIP (images), or PDF to strip special symbols, punctuation, and emojis, resolving file saving and export issues on the web.
Smooth Window Resizing: Fixed a visual glitch where hymn details and sheet music previews would reload/flash when resizing the window. Details and previews now stay loaded and resize instantly.
Enhanced Active Highlights: Active selections in the hymns list, search results, and index lists are now highlighted with a styled secondary button and primary colors to easily track what you are viewing.
Automatic Scroll Reset: Selecting a new hymn now automatically resets the details scroll position back to the top.
Polished Website Design: Redesigned the web landing page with clean, responsive sections, glow backdrops, and entrance transitions.
Public Domain Info: Added a dedicated card detailing public domain hymns—lyrics can be viewed by all users, while exporting PowerPoint slides and images is part of the Pro subscription.

v5.5.7

PowerPoint & Image Exports: Resolved slide background image zooming and cropping issues on PowerPoint (PPTX) and image exports, including a fix for high-DPI scaling on Windows browsers.
Consistent Footers: Standardized slide footer display to ensure visual consistency across all exports.

v5.5.6

Export Alignment: Resolved image export zoom and cropping issues.
Aspect Ratio Consistency: Standardized slide aspect ratio rendering across all PowerPoint exports.

v5.5.5

Quick Look Previews: Fixed PowerPoint (PPTX) file previews on iOS and macOS Finder (Quick Look).

v5.5.4

Downloads: Fixed the download URL helper.

v5.5.0

Simplified Purchase Flows: Fixed and streamlined subscription purchase flows.
Streamlined Interface: Simplified the user interface and plan offerings.
Library & Sync Improvements: Fixed hymn downloads, user authentication, and list syncing.
New Sheet Music Renderer: Upgraded to a faster and cleaner sheet music renderer.
Inline Previews: Added instant inline previews for sheet music and slides.

v5.0.0

Modernized Interface: Launched a new application user interface.
PDF Exports: Added support for PDF exports.
Flexible Licensing: Added single hymn credit and full hymnal export lifetime purchase options.
User Lists: Switched to Lists instead of Playlists.
Offline First: The app now works offline by default, loading local database records first.
Web Purchases: Added support for website purchases.

v4.6.2

Responsive Design: Added a responsive layout for the hymns list view.
Search Optimization: Fixed search reliability issues.

v4.6.1

Dynamic Sidebar: Added a collapsible, dynamic navigation sidebar.
Authentication: Fixed sign-in and authentication issues.
Decimals in Numbering: Fixed hymn searching for numbers containing decimal points.

v4.6.0

Integrated Links: Added links to external items on the hymn detail view.
Detail Side Panels: Added a persistent hymn details side panel on desktop and a modal dialog on mobile.
Internal Slide Viewer: Added an internal viewer to preview PowerPoint exports.

v4.5.0

Presentation Creator: Added the new Presentation Creator tool in the sidebar.
Account Verification: Added automated account access checks.
Auto-Updates: Fixed local library update syncing.
Purchase Sync: Fixed issues where purchased hymnals were not showing.
Session Persistence: Fixed an issue where accounts would not stay signed in.
Hymn Dial Pad: Added a new quick-entry dial pad for hymns.
Filtered Search: Fixed search filters.
Incremental Downloads: Removed the need to download large hymn archives; images now download incrementally.

v4.1.1

Lyrics Display: Fixed an issue where the 'End of Song' indicator was not showing for hymns without a chorus.
Presentation Menus: Added new quick-access menu items to the Presentation Creator.

v4.1.0

App Branding: Updated the application name and branding.
Multi-Platform Playlists: Fixed calendar playlist links across platforms.
Playlist Enhancements: Added support for supplement, public, and medley types to playlists.
Presentation Creator: Added the ability to open the Presentation Creator directly from a playlist.
Purchase Synchronization: Fixed issues with web purchase syncing.

v4.0.0

Simplified Navigation: Removed unnecessary screens and simplified layouts.
Split-View Layout: Added a split-view presentation for hymns and playlist details.
Website Purchase Syncing: Linked web-based purchases with in-app accounts.
In-App Tutorials: Added tutorials to help users navigate the app.
Asset Streaming: Switched to incremental hymn asset streaming to save storage space.
Optimized Exports: Only PPTX/PDF exports require downloading full hymn packages now.
Offline Synchronization: Improved overall database loading when offline.

v3.2.0

Faster Downloads: Optimized download speeds and fixed the download button.
Search Fixes: Fixed general search indexing bugs.
Update Banners: Added banner notifications when a new library update is available.

v3.1.0

Seamless Restore: Wait to restore purchases until after the user has successfully signed in.
Lifetime Purchases: Fixed lifetime purchase license detection.
Music Options: Added support for a small print music layout option.
Quick Add: Re-added the "Add to Playlist" button directly on the hymn details view.
Image Viewer: Fixed a user interface layout bug when entering or exiting full screen in the image viewer.

v3.0.7

Purchase Restoring: Fixed in-app purchase restoration flow.
Lifetime Option: Fixed lifetime license sync.

v3.0.6

CDN Integration: Switched to a content delivery network (CDN) for significantly faster downloads.

v3.0.5

Color Slides: Fixed a slide background color rendering issue on playlists.

v3.0.3

Paywall Access: Fixed validation issues on subscription paywall screens.

v3.0.2

Account Status: Clarified description of account types.
Pricing Details: Updated the subscription pricing layout.

v3.0.1

Interactive Paywalls: Added interactive paywall dialogues and updated the pricing screen.
Subscription Names: Fixed a bug displaying incorrect subscription tier titles.

v3.0.0

Refined Layout: Redesigned the primary application layout and user interface.
PowerPoint Footers: Added footer text options for PowerPoint exports.
Sidebar Navigation: Added a modern collapsible navigation sidebar.
Hymns Downloader: Integrated a batch downloader for offline hymns.
Offline Assets: Stored all hymn images locally for offline availability instead of streaming.
Connectivity Indicators: Added status icons for Wi-Fi and server connectivity.
Dynamic Image Viewer: Overhauled the image viewer with swipe navigation, pinch-to-zoom, and section chips.
E-Ink Display Support: Optimized the user interface layout for e-ink displays.
Performance Boost: Sped up overall app responsiveness, prioritizing local database lookups.

v2.3.5

Lyrics Sizing: Increased the maximum and minimum font sizes available for lyrics.

v2.3.4

Plan Upgrades: Fixed a rare bug affecting plan upgrades and licensing status.

v2.3.3

Restores & Upgrades: Fixed subscription restoring and plan upgrade/downgrade logic.

v2.3.2

Search Screen: Redesigned the search interface.
Pending Subscriptions: Added validation for unconfirmed/pending subscriptions.

v2.3.1

Auth Improvements: Resolved authentication errors.
Restores: Fixed purchase restore processes.
Lifetime Options: Added lifetime purchase options for HFWR and HFWS hymnals.

v2.3.0

Subscription Tiers: Transitioned to subscription tiers (Basic and Pro).
PowerPoint Out of Beta: PowerPoint export is officially out of beta and included in the Pro tier.
PDF Export Removal: Temporarily removed PDF export.
Account Management: Added a billing management page to update subscriptions.
Expanded Basic Tier: The Basic subscription tier now includes access to all hymns.
Grandfathered Purchases: Converted past individual hymnal purchases into lifetime view-only access.

v2.2.10

Student Access: Fixed credentials validation for student accounts.
Simplified Menus: Removed complex nested menus in favor of a clean layout.
Breadcrumbs: Added breadcrumbs navigation.
Metadata Details: Updated detail views.
Interactive Table: Added a sortable tabular view for hymns.
Database Migration: Switched to a robust database and auth provider, with automatic email-based migration.

v2.2.9

Startup Stability: Fixed startup crashes on specific devices.
Google Sign-In: Fixed Google authentication issues.

v2.2.8

Offline Performance: Improved offline caching.
Shareable Playlists: Added support for opening playlists via shared web links.
Link Search: Added support for searching via direct web links.

v2.2.7

Selection Interface: Fixed selection behavior for hymns, topics, and stakeholders.
Drawer Favorites: Added a favorites list inside the menu drawer.
Theming: Added additional application color themes.

v2.2.6

Account Linking: Added support for linking RJStevensMusic web purchases.
Push Notifications: Added push notifications support.
App Reviews: Prompt users to review the app.
Menu Dropdowns: Fixed dropdown layouts.

v2.2.5

eChoice Plan: Fixed subscription activation issues for the eChoice plan.

v2.2.4

Home Screen: Updated the home page feed dashboard.
Sorting: Added list sorting options.
Hymn Feed: Added a links and announcements feed.

v2.2.3

Library Loading: Fixed library assets failing to load.
Grid Layouts: Added multi-column list layouts for tablets and desktops.
Auto-Updates: Added automatic background library updates.

v2.2.2

Indexes: Added General, Topical, Scripture, and Key/Time indexes.
Authentication: Fixed Google Sign-in credential errors.

v2.2.1

Search Deduplication: Fixed duplicate items appearing in search results.
Offline Retry: Added offline queue and automatic retry for user changes.
GraphQL API: Switched to GraphQL for fast user data updates.

v2.2.0

Tabs Editor: Added support for editing visible tabs in settings.
Responsive Layouts: Overhauled desktop and tablet responsive grid views.
Drawer: Added a collapsible side drawer on the home screen.
Playlist Features: Added calendar, search, statistics, and favorites for playlists.
Related Hymns: Display related hymns from other hymnals.

v2.1.25

Slides Loading: Fixed slide image loading for specific hymn sections.

v2.1.24

Subscription Load: Fixed loading issues on the subscription screen.
Shared Links: Fixed shared links routing on post-installation launch.
Apple Watch: Launched the companion Apple Watch app.

v2.1.23

SQLite Database: Upgraded to a fast, read-only SQLite database for local library storage.
Auth Help: Added an authentication help and troubleshooting page.

v2.1.22

Sync Button: Added a manual sync button inside settings.
Restoration: Fixed in-app purchase restores.

v2.1.21

Playlist Loading: Fixed playlist loading bugs.
Performance: Improved loading speeds on home and hymn screens.
Storage Optimization: Switched to temporary directory storage for downloaded slide images to save user disk space.

v2.1.20

Offline Improvements: Fixed library loading errors for eChoice users.
Faster Startup: Optimized initial database creation on first launch.

v2.1.19

Image Loading: Fixed duplicate and broken images in the image gallery.

v2.1.18

Internal Viewer: Integrated an in-app slide viewer.
Image Inversion: Added an option to invert sheet music images (dark mode support).
Interactive Playlists: Added swipe actions to playlist items.
Social Engagement: Added follow buttons for topics/authors and like buttons for hymns.

v2.1.17

Full Screen Gallery: Added enter/exit full-screen actions on sheet music.
Google Sign-In: Added Google Sign-In.
Refresh Actions: Added manual refresh buttons for playlist details.

v2.1.16

Backend Upgrade: Upgraded to a new database and backend provider.
Global Search: Added global search across hymns, lyrics, and metadata.
Offline Support: Improved offline mode.

v2.1.15

Grid/List Switcher: Added an option to toggle between list and grid views.
Save/Restore Tabs: Introduced a beta feature to save and restore active tabs.
Offline Assets: Re-introduced offline library assets.

v2.1.14

Tabbed Layout: Added tabs to allow multi-tasking.
Optional Sign-In: Allowed searching and reading hymns without requiring an account.

v2.1.12

Dynamic Color: Added dynamic color theming across platforms.
Sign In with Apple: Added Sign In with Apple.
Breakpoints: Corrected layout breakpoints for desktop monitors.

v2.1.11

Live Streaming: Sped up live event updates and streaming.
Navigation Rail: Added a vertical navigation rail on wide screens.
Pitch Pipe: Fixed pitch pipe link.

v2.1.8

Notation View: Added sheet music notation previews.
Lyrics Export: Added a quick "Copy Lyrics" action button.

v2.1.0

Redesigned UI: Overhauled the core user interface.
File Exports: Added PowerPoint, Excel, PDF, Email, and Markdown export tools.
Presentations: Added presentation management.
FAQ Page: Added an in-app FAQ section.

v2.0.4

Copy Lyrics: Added quick copy lyrics button.
Nested Navigation: Simplified app navigation with nested routing.
Search Popup: Added a quick search modal.
Name Generator: Added a playlist name generator.

v2.0.0

Tablet Layout: Added a responsive tablet layout.
Song Slides: Integrated slide rendering.
Preview Mode: Added a guest preview mode.
Multi-Language: Added multi-language localization.

v1.0.8

iPad Support: Added iPad split-view support.
Dark Mode: Fixed dark mode theme colors.
Trending: Added a trending hymns feed on the home screen.

v1.0.3

eChoice Integration: Integrated the eChoice hymnal.
Tab Bar: Reorganized the main navigation tab bar.
Image Zoom: Added pinch-to-zoom on sheet music.
Offline Database: Added a local offline database.
Bible: Integrated Bible scriptures.

v1.0.0

Initial Launch: Released the first version of the Hymns for Worship application.