Skip to content

Repository files navigation

🌍 Lore

track your exploration of the world

✨ About Lore

Lore is an interactive web app that helps you track trips, log locations, and build visual stories on a map.

Inspired by that all-too-familiar question — “How was your trip?” — Lore gives you a better answer than words or messy photo dumps. You can organize locations into trips, add details, and relive your adventures on an interactive map.

Whether it’s a road trip across states or a weekend in your city, Lore helps turn moments into a visual timeline.

✅ Features

  • Create trips to group locations together

  • Add locations with details (tags, dates, notes, images coming soon)

  • View interactive maps powered by Google Maps

  • Marker clustering for clean visualization

  • Dynamic trip filtering

  • Firebase Auth for personalized profiles

  • Responsive design with smooth animations

🖼 Demo

🛠 Tech Stack

Frontend: React (TypeScript), Framer Motion, TailwindCSS

Map Engine: Google Maps JavaScript API

Backend: Firebase (Auth + Firestore)

Deployment: Netlify

🚀 Getting Started

Follow these steps to run Lore locally:

  1. Clone the repo git clone https://github.com/yourusername/lore.git cd lore

  2. Install dependencies npm install

or

yarn install

  1. Set up environment variables

Create a .env file in the root and add:

NEXT_PUBLIC_FIREBASE_API_KEY=your-key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your-domain
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your-project-id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your-bucket
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your-id
NEXT_PUBLIC_FIREBASE_APP_ID=your-app-id
GOOGLE_MAPS_API_KEY=your-maps-api-key
  1. Start the development server npm run dev

  2. Open in browser

Go to http://localhost:8888

🖱 How to Use the App

Sign up or log in with Firebase Auth.

Create a trip (e.g., “Summer 2025 Europe Trip”).

Add locations to your trip using the map:

Search for a location OR click on the map to drop a pin

Add tags, notes, and metadata

Explore your map

Use filters to toggle between trips

Zoom in/out for marker clusters

Save your adventures — your trips sync in real time!

🔮 What’s Next

📷 Add photo uploads for locations

👥 Collaborative maps for group trips

✨ Public profiles to share your adventures

🔍 Smart recommendations based on your travels

🧠 Why I Built This

Because “How was your trip?” deserves a better answer than just “it was good.” Lore turns your travels into a story you can see, relive, and share.

🤝 Contribute

Feel free to fork the repo (must credit me), submit issues, or suggest new features (i welcome new suggestions always :))!

📬 Contact

Built by Mitesh Shah

Email: miteshmanishshah@gmail.com

About

Personalized Google Maps-powered Life Lore Tracker and Memory Vault

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages