TimeMarker

TimeMarker is an interactive web application that lets users explore historical and speculative future narratives based on specific geographical locations and time periods. Built with Next.js and enhanced with modern UI components, it combines temporal and spatial data to generate unique historical perspectives.

Features

• Interactive Time Selection: Choose any year using an intuitive year picker
• Location Selection: Multiple ways to select locations:
  • Manual coordinate input
  • Current location detection
  • Interactive map picker with OpenStreetMap integration
• AI-Powered Historical Narratives: Generates detailed historical or futuristic accounts based on selected time and location
• Responsive Design: Fully functional across desktop and mobile devices
• Dark/Light Theme: Supports system preference and manual theme switching

Technology Stack

• Framework: Next.js 14
• Styling: Tailwind CSS
• UI Components: shadcn/ui
• Maps: Leaflet with React-Leaflet
• Font: Geist Font Family
• AI Integration: Groq API with Llama3 model
• Form Handling: React Hook Form with Zod validation

Getting Started

1. Clone the repository
2. Install dependencies:

   npm install
   

3. Run the development server:

   npm run dev
   

4. Open http://localhost:3000 in your browser

Usage

1. Navigate to the main page
2. Click "Get Started"
3. Select a year you want to explore
4. Choose a location using one of the available methods:
   • Enter coordinates manually
   • Use your current location
   • Pick a location on the map
5. Click "Start Journey" to generate a historical narrative

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

All rights reserved. Created by Leytox

Support Ukraine 🇺🇦

This project stands with Ukraine. Visit Stand With Ukraine to learn more.