Institutional Project Brief · VAULT-02

Hmar Digital Library

The Hmar Digital Library is an archival initiative currently in planning. Below is an outline of the intended usage model, proposed technical design philosophy, and planned storefront architecture for when active development begins.

Proposed Technical Specifications

SpecificationIntended Details
Storefront PortalProject Not Initialized
Source Code RepositoryProject Not Initialized
Intended ArchitectureAccountless Static Site Build · One-Stop Public Download Storefront
Management ScopeZero Management Features · Curation Managed via Project Repositories

Intended One-Stop Storefront Vision for All Open Data

The intended design vision for the Hmar Digital Library is to serve as a one-stop public storefront for downloading all Hmar open data. Rather than scattering digitizations across isolated drives or requiring developers to navigate complex code repositories, the portal aims to provide 1-click downloads for PDF books, rare 20th-century manuscripts, folk songbooks Hla-thlang, audio recordings, compiled dictionary term exports from the hmar open lexicon, and ready-to-use software translation key bundles from the hmar locale project.

Proposed Accountless & Read-Only Design Philosophy

The proposed architecture prioritizes frictionless public access. Under this design philosophy, the storefront contains zero administrative forms, management dashboards, or login portals, fully justifying an accountless static site build. Visitors will not need to register or provide personal tracking data to browse or download materials. Every public asset is intended to be accessible with a single click.

Separation of Management & Visual Staging Layers

All data curation, pull request reviews, moderation, and asset ingestion management will reside purely within their respective projects, primarily inside the repositories and dataset pipelines of the hmar corpus archival project. While dedicated project portals cater to active contributors and translators, this storefront acts strictly as the visual reading and downloading layer. When volunteers submit new texts or transcriptions to the underlying repositories, an automated staging build renders their pending submissions live under an in-review status. This separation ensures contributors receive instant visual feedback while keeping the storefront 100% static and secure without backend management complexity.

Planned Cross-Repository Data Pipeline

Executing a static storefront successfully requires establishing a disciplined cross-repository pipeline before launching public builds. Asset manifests, OCR layers, audio files, compiled lexicon databases, and standardized software locale files (in i18n JSON, PO, and XLIFF formats) will originate from specialized repositories. Establishing standardized JSON schemas and automated static site generators serves as a structural prerequisite for synchronizing data across repositories into this central storefront.

Intended Archiving & Copyright Principles

Archival priorities focus primarily on public domain literature and historical manuscripts. For out-of-print contemporary publications, policy dictates securing written archiving consent from authors, families, or copyright holders prior to scanning or public distribution.

Planned Architectural Deliverables

  • One-stop public download storefront for PDF books, folk songbooks, and audio recordings
  • Direct 1-click downloads of compiled software locale bundles (i18n JSON, PO, XLIFF)
  • Accountless static web application with zero management complexity or tracking requirements
  • Separation of concerns routing all curation and moderation to underlying project repositories
  • In-review staging layer enabling contributors to see pending submissions rendered visually