Skip to content

DigitalHumanitiesCraft/CorrespExplorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

License

CC BY 4.0

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

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •