Skip to content

KaloudasDev/pontus-historical-map

Repository files navigation

Historical Map of Pontus

Professional interactive web application showcasing seven significant cities of the Pontus region with historical information and imagery. Built with modern web technologies for optimal performance and user experience.

Overview

This project presents an interactive historical map of Pontus, featuring seven major cities of Greek presence in Asia Minor and the Black Sea region. The application combines geographic visualization with rich historical content, providing an educational and visually compelling experience.

Featured Cities

  • Σμύρνη (Smyrna) - Cosmopolitan center of Ionian civilization
  • Αμάσεια (Amaseia) - First capital of the Kingdom of Pontus
  • Μάδυτος (Madytos) - Thriving commercial hub of Thracian Chersonese
  • Αδραμύτιο (Adramytio) - Major Mysian trade center
  • Κασταμονή (Kastamoni) - Strategic Paphlagonian fortress city
  • Καλλικράτεια (Kallikrateia) - Ancient Pontic trading post
  • Κωνσταντινούπολη (Constantinople) - Queen of Cities, Byzantine capital

Features

  • Interactive Map Interface - Smooth pan, zoom, and navigation controls
  • City Markers - Custom-designed animated markers for each location
  • Information Panels - Detailed historical descriptions with imagery
  • Responsive Design - Optimized for desktop and mobile viewing
  • Smooth Animations - Professional-grade transitions and effects
  • Clean Architecture - Modular React components for maintainability

Technology Stack

Component Technology
Build Tool Vite
Package Manager npm
Animations Framer Motion
Frontend Framework React 19
Styling CSS3 with Glassmorphism
Map Integration Leaflet + React-Leaflet

Installation

# Clone repository
git clone https://github.com/kaloudasdev/pontus-historical-map.git

# Navigate to project
cd pontus-historical-map

# Install dependencies
npm install

# Start development server
npm run dev

Deployment

# Build for production
npm run build

# Preview production build
npm run preview

Project Structure

pontus-historical-map/
├── src/
│   ├── assets/          # Icons and static resources
│   ├── data/            # City data and configurations
│   │   └── cities.js    # Historical city information
│   ├── App.jsx          # Main application component
│   ├── App.css          # Application styles
│   ├── index.css        # Global styles
│   └── main.jsx         # Application entry point
├── index.html           # HTML template
├── package.json         # Dependencies and scripts
└── vite.config.js       # Vite configuration

Important

Node.js version 16 or higher is required for development.

Usage Guide

  1. Browse Cities - Click city names in the left sidebar
  2. Explore Map - Navigate using mouse/touch controls
  3. View Details - Click markers for quick information
  4. Access History - Select cities for comprehensive historical data
  5. Close Panels - Use the X button to return to map view

Historical Context

The Pontus region (Εύξεινος Πόντος) represents one of the most significant areas of Hellenic civilization outside mainland Greece. From the establishment of Miletian colonies in the 8th century BCE to the population exchange of 1923, Greek communities thrived along the Black Sea coast and interior Anatolia for nearly three millennia.

Tip

Use the interactive map to explore the geographic relationships between these historically connected cities.

Important Notice Regarding Historical Information

The historical data, population figures, and descriptions presented in this application have been compiled from various sources and may contain inaccuracies or require verification.

Please note:

  • Population estimates prior to 1922 are approximate
  • Historical boundaries and locations may differ from modern geography
  • Some information may be subject to ongoing historical research

Caution

If you identify any inaccuracies or have verified historical information to contribute, please report it through the appropriate channels or contact us directly so we can improve the educational value of this project.

Contributing

Contributions are welcome! Please ensure:

  • Historical accuracy is maintained
  • Code follows existing architecture
  • Testing is performed locally

License

This project is licensed under the MIT License. See LICENSE file for details.

Academic Context

Developed as a student project for Greek history and geography education, demonstrating the integration of modern web technologies with traditional historical research.

Caution

All historical data is provided for educational purposes. Population figures represent estimates prior to 1922.

About

Interactive historical map of Pontus featuring 7 significant cities of Greek presence. Built with React, Leaflet & Framer Motion. Clean and responsive.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Sponsor this project

Contributors