更新履歴
Release history, new features, and platform improvements across 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 (Lyricswith document icon & theme-harmonized Rose/Coral,Viewwith eye icon & theme-harmonized Amber/Gold, andExportwith 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 × 2556px), 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_databucket sync endpoint (GET /v1/users/me/lists-sync) that streams only the signed-in user's3#user_dataPowerSync bucket (skipping the 41 MBlibrary_datacatalog stream) and enriches list items from the server's in-memory catalog in ~130ms, added direct HTTP write-through to/api/powersync-uploadfor 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 fullportionsand 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/403insideHttpPowerSyncConnector(fetchCredentialsanduploadData), a poisoned CRUD row circuit breaker, automatic migration of bothlocal_guestlists and list items (user_lists,user_list_items, and pendingps_crudentries) to the signed-in user, browser lifecycle (visibilitychange,pageshowbfcache,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, strictno-storecache headers on.dart.js,powersync_db.worker.js,sqlite3.wasm, andmanifest.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 viaImageIO(CGImageSourceCreateThumbnailAtIndex) on iOS andBitmapFactoryon 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 (
HfwSlideStageImageViewon iOS andhfwPrewarmSlideBitmapson 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
MagnificationGesturebranch-swapping view with a hardware-accelerated UIKitUIScrollView(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_idis missing fromlocalStorageor 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 Resultsstate 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, nativeFormgrouped Profile settings, andTabViewBottomAccessorymini-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 (
NavigationSplitViewon 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 withslides-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_flutter10.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.