Community Technology · Project case study
Rongmei Hymnal
An installable, offline-first digital hymnal and preservation project bringing 1,271 songs from three Rongmei and community song collections into one searchable reading space.
Status · Active · deployed · editorial review ongoing
Purpose
Preserving songs without separating them from their community context.
Rongmei Hymnal is a community-focused digital library created to make Rongmei gospel songs easier to search, read, preserve, and use across phones, tablets, and computers.
Instead of merging every source into an anonymous catalogue, the project keeps individual songbooks identifiable and retains collection-level credits, source information, editorial notes, publication context, and rights metadata wherever available.
Collection
Three collections and 1,271 songs in one searchable library.
- Buanthanhlu: 305 songs
- Hymdaihlu: 930 songs reconstructed from a legacy SQLite hymnal database
- VBS Songs: 36 traditional or public-domain English selections
- A central JSON registry defines available books, metadata locations, collection versions, and song counts
- Per-book metadata keeps source, editorial, attribution, publication, and rights information separate from the application interface
Experience
Designed for focused reading, community use, and unreliable connectivity.
- Search across registered songbooks
- Focused song-reading view
- Reading preferences for phones, tablets, desktops, and larger displays
- Presentation mode for group reading and worship
- Local favourites and recent history
- Installable Progressive Web App
- Explicit full-library download for offline reading and searching
- Offline-download progress, storage state, and collection update handling
Editorial status
A working digital edition that continues to be corrected.
The software is deployed and usable, but the hymn corpus should not be represented as a final critical edition. Some source material contains transcription errors, spelling inconsistencies, punctuation problems, formatting differences, duplicate or legacy records, and metadata that still requires human review.
Corrections are being made progressively against available hymnbooks, source records, community knowledge, and legacy data. When a correction cannot be verified confidently, preserving provenance and marking uncertainty is preferable to presenting an assumption as authoritative text.
Architecture
Static, offline-capable PWA with separate application and collection layers.
Static HTML views provide the main library, collection browsing, and focused hymn-reading experiences. A central registry identifies collections and versions, while each songbook maintains structured metadata and song records.
The service worker caches the application shell for startup resilience. A separate in-app workflow stores registered songbook metadata and content for offline use, so installing the PWA is not confused with downloading the entire library.
Preservation
Structured data turns a reading app into a maintainable digital archive.
Separating application code from structured songbook data makes collections easier to inspect, validate, migrate, correct, and preserve as technologies change.
Versioned collection metadata also provides a foundation for future correction tracking, source comparison, and community-reviewed editions without redesigning the entire application.
Stewardship
Open software does not mean unrestricted hymn content.
The Apache License 2.0 applies to the project's software, interface code, tools, and documentation. It does not automatically relicense lyrics, editions, translations, arrangements, recordings, illustrations, cover art, or other collection material.
Publication note
Static, crawlable case study.
This page contains the substantive project description directly in HTML. The existing GLab project catalogue and JavaScript interface can continue to operate independently.