Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

364 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CorrespExplorer

Interactive visualization tool for correspondence metadata in CMIF (Correspondence Metadata Interchange Format).

Live Demo: https://dhcraft.org/CorrespExplorer

Quick Start

  1. Visit https://dhcraft.org/CorrespExplorer
  2. Upload a CMIF-XML file or select the example dataset (Hugo Schuchardt Archiv)
  3. Explore the correspondence through 10 different views

For local development:

cd docs
python -m http.server 8000
# Visit http://localhost:8000

Features

  • CMIF-XML file upload (drag-and-drop or URL)
  • correspSearch API integration
  • Wikidata enrichment (portraits, life dates, professions)
  • 10 visualization views (map, timeline, network, chronicle, etc.)
  • Multi-dimensional filtering (time, language, person, subject, place)
  • CSV/JSON export
  • URL-based state sharing

Example Dataset

Hugo Schuchardt Archiv (HSA) - correspondence of linguist Hugo Schuchardt (1842-1927):

Metric Value
Letters 11,576
Correspondents 846
Places 774
Subjects 1,622
Languages 18
Time Period 1859-1927

Technology Stack

  • MapLibre GL JS 4.x (WebGL map rendering)
  • D3.js with D3-Sankey (network and flow diagrams)
  • noUiSlider (time range filtering)
  • Vanilla JavaScript ES6 modules
  • No build process required

Documentation

Detailed documentation in docs/knowledge/:

Document Purpose
architecture.md Technical architecture, modules, data flow
user-stories.md 32 implemented features with acceptance criteria
design.md UI/UX specifications, design system
JOURNAL.md Development history (37 phases)
testing.md Test strategy (74+ tests)
CONTEXT-MAP.md Documentation overview

Development

Run tests in browser:

docs/test.html?test=true

See CLAUDE.md for coding guidelines.

Licence

Code is licensed under the MIT License (see LICENSE). Documentation and knowledge documents are licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). Third-party research data is excluded from these terms; rights remain with their respective holders. The bundled example correspondence dataset (Hugo Schuchardt Archiv) remains with the archive.

Resources

Development Methodology

Developed by Christopher Pollin using Claude (Opus 4.5) with the Promptotyping methodology.

More information: Promptotyping: Von der Idee zur Anwendung

Contact

Christopher Pollin Digital Humanities Craft OG https://dhcraft.org

About

Interactive visualization tool for correspondence metadata in CMIF (Correspondence Metadata Interchange Format).

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages