Harappan Civilization Explorer

Inspiration

Most students meet the Harappan Civilization as a short chapter, a few famous sites and a list of facts. But the actual story is richer: uncertain scripts, changing rivers, planned cities, craft networks, disputed interpretations and a civilisation spread across a huge landscape. I wanted to build a learning experience that feels like entering an archaeological field studio, where learners can see evidence, test ideas and understand why historians often speak in probabilities rather than final answers.

What it does

The app presents a complete offline exploration of the Harappan Civilization. Learners can open a living map of Harappan sites, switch between Early, Mature and Late Harappan phases, inspect major sites such as Harappa, Mohenjo-daro, Dholavira, Rakhigarhi, Kalibangan and Lothal, and optionally enable modern reference boundaries for orientation.

It also includes interactive learning worlds for drainage, water management, brick ratios, weights, trade networks, seals, the undeciphered script, burial evidence, decline theories and Harappan-Vedic comparison. A cinematic documentary mode guides learners through major debates, while local progress tracking lets them see which worlds they have explored. The app works fully offline and stores progress only in the browser.

How we built it

The project is built as a static offline web application using HTML, CSS and JavaScript. The main application lives in index.html, with a local Harappan map engine in assets/harappan-map-engine.js. It uses embedded assets, local data, local storage and browser-native controls so it can run directly from a folder or ZIP without a server.

The map, learning modules and documentary content were organized around evidence-led historical reasoning. Each major topic tries to separate established archaeological evidence, cautious interpretation, scholarly debate and outdated claims. Codex and GPT-5.6 helped convert the project into a standalone Harappan-only experience, remove unrelated branding, refine the map behavior, generate judge-ready documentation and package the final submission.

Challenges we ran into

The biggest challenge was balancing visual drama with historical caution. A beautiful map is easy to overstate; a responsible map needs to show uncertainty, approximate ancient geography and modern boundaries without confusing them. Another challenge was keeping the app completely offline while still feeling rich, cinematic and interactive.

We also had to keep the scope disciplined. Every screen, label and module had to support the Harappan Civilization directly. The modern reference boundary required extra care so it remained a faint optional context layer, not the main historical message.

Accomplishments that we're proud of

I am proud that the final app is not just a page of notes. It is a complete interactive learning environment: map, documentary, simulations, progress tracking, evidence labels and reflection. It can be shared as a simple ZIP, opened through index.html, and used without accounts, internet, telemetry or installation.

I am also proud of the evidence-first tone. The app does not pretend the Harappan script is deciphered, does not reduce decline to a single dramatic cause, and does not flatten the Harappan-Vedic relationship into a simplistic claim. It teaches learners how historical knowledge is built.

What we learned

We learned that educational technology is not only about making content attractive; it is about making uncertainty understandable. The Harappan Civilization is ideal for this because so much of it depends on reading material evidence carefully: bricks, drains, seals, site layers, river patterns, burial contexts and trade objects.

We also learned how important product boundaries are. By removing unrelated history content and keeping the focus tightly on Harappan archaeology, the experience became clearer and more memorable. Codex and GPT-5.6 were most useful when the work required many small connected decisions: renaming, auditing, rewriting, packaging, testing and turning a local prototype into a competition-ready project.

What's next for Harappan Civilization Explorer

Future versions could add more site-level evidence cards, teacher lesson plans, quiz modes, multilingual narration, more precise GIS layers, source-linked bibliography panels and printable classroom worksheets. Another important next step would be expert review by archaeologists or history educators so the app can become an even stronger classroom resource.

Built With

• archaeology
• codex
• css
• education
• gpt-5-6
• history
• html
• interactive-map
• javascript
• localstorage
• offline