# Timelory - Interactive Historical Timelines & Empire Maps
> Timelory is an educational web application for creating, exploring, and sharing interactive historical timelines, dynasty genealogies, and empire border maps through time.

## About Timelory
Timelory helps educators, students, researchers, and history enthusiasts visualize history through:
- Interactive timeline creation with tracks and events
- Historical atlas showing empire borders from 3000 BCE to present
- Dynasty family tree genealogy visualization
- Roman road network mapping
- Multi-language support (English, German, French, Spanish, Japanese, Chinese, Arabic, Hebrew)

## Main Features

### Historical Articles
In-depth articles written by historians and enthusiasts covering:
- Ancient empires and civilizations (Assyria, Babylon, Rome, Persia, etc.)
- Historical events and turning points
- Timeline integrations for visual context
- Community discussions and comments
- Subscribe to RSS/JSON feeds for new articles

### Historical Atlas
The Historical Atlas displays empire and nation borders as they changed throughout history using GeoJSON data. Users can:
- Slide through time to see border changes year-by-year
- View multiple empires simultaneously
- Explore ancient civilizations like Rome, Babylon, Assyria, Persia, China, and more

### Timeline Creator
Users can create custom timelines with:
- Multiple tracks (parallel timelines for different categories)
- Events with dates, descriptions, and images
- Customizable colors and styling
- Export and sharing capabilities

### Dynasty Trees
Visualize ruling family genealogies including:
- Succession paths
- Ruler reign dates
- Historical events during each reign
- Family relationships

## API Information
Timelory provides a REST API at api.timelory.com for accessing:
- Historical region GeoJSON data by year
- Dynasty and ruler information
- Timeline data structures

## Data Sources
Our historical border data comes from academic sources including:
- Historical Basemaps project
- Academic historical atlases
- Primary source documents

## Technical Details
- Frontend: React + TypeScript + MapLibre GL
- Maps: Vector tiles with historical overlays
- Data Format: GeoJSON for geographic data, JSON for timelines

## Available Content

### Pre-built Timelines
- Assyrian Empire Timeline (2025 BCE - 609 BCE)
- Roman Empire Timeline (753 BCE - 476 CE)
- Chinese Dynasties Timeline (2070 BCE - 1912 CE)
- Byzantine Empire Timeline (330 CE - 1453 CE)
- Ottoman Empire Timeline (1299 CE - 1922 CE)
- Egyptian Pharaohs Timeline
- Persian Empire Timeline
- Mesopotamian Civilizations Timeline

### Historical Periods Covered
- Ancient Near East (Sumerians, Akkadians, Babylonians, Assyrians)
- Classical Antiquity (Greece, Rome, Persia)
- Medieval Period (Byzantine, Islamic Caliphates, European Kingdoms)
- Early Modern Period (Ottoman, Safavid, Mughal Empires)
- Modern Era (Colonial empires, World Wars, Contemporary borders)

## Contact
- Website: https://timelory.com
- API: https://api.timelory.com
- Contact: https://timelory.com/contact

## License
Content is provided for educational purposes. Historical data is available under CC BY-NC 4.0.

## Quick Links
- Homepage: https://timelory.com/
- Atlas: https://timelory.com/atlas
- Timelines: https://timelory.com/timelines
- Articles: https://timelory.com/articles
- Dynasty Trees: https://timelory.com/dynasty-tree
- History Encyclopedia: https://timelory.com/history/
- API Documentation: https://timelory.com/api-docs.html
- OpenAPI Spec: https://timelory.com/openapi.yaml
- Pricing: https://timelory.com/pricing

## Featured Articles
- Assyrian Empire Timeline: https://timelory.com/history/assyrian-empire.html
- Historical Atlas Guide: https://timelory.com/history/historical-atlas.html

## Machine-Readable Resources
- Knowledge Graph (JSON-LD): https://timelory.com/knowledge-graph.jsonld
- RSS Feed: https://timelory.com/feed.xml
- JSON Feed: https://timelory.com/feed.json
- Articles RSS Feed: https://api.timelory.com/api/articles/feed/rss
- Articles JSON Feed: https://api.timelory.com/api/articles/feed/json
- Articles Sitemap: https://api.timelory.com/api/articles/sitemap.xml
- AI Policy: https://timelory.com/ai.txt