Skip to content

Latest commit

 

History

History
93 lines (66 loc) · 2.55 KB

File metadata and controls

93 lines (66 loc) · 2.55 KB

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