🗺️ Pathfinder

A modern, interactive mapping application built with Next.js 15, MapboxGL, and TypeScript. Pathfinder provides a seamless mapping experience with features like real-time weather data, location search, and customizable map styles.

Demo · Report Bug · Request Feature

✨ Features

🌓 Dark/Light mode support
🏢 3D Building visualization
🔍 Location search with autocomplete
🌤️ Real-time weather information
📍 Current location detection
🛰️ Street/Satellite view toggle
📱 Fully responsive design
⌨️ Keyboard shortcuts support
🎨 Modern UI with Tailwind CSS and shadcn/ui

🚀 Getting Started

Prerequisites

Node.js 22+
A Mapbox API key (get it from Mapbox)
A OpenWeather API key (get it from OpenWeather)
npm or yarn

Installation

Clone the repository:

git clone https://github.com/shadowoff09/pathfinder.git
cd pathfinder

Install dependencies:

npm install
or
yarn install

Set up environment variables:
Copy the .env.example file to .env.local:

     cp .env.example .env.local
     ``
   Open .env.local and add your Mapbox API key:

     
`env
     NEXT_PUBLIC_MAPBOX_ACCESS_TOKEN=your_mapbox_token_here
     NEXT_PUBLIC_WEATHER_API_KEY=your_weather_api_key_here
     `
   Get your API keys from:
     Mapbox - for map functionality
     OpenWeather - for weather data
Start the development server:

bash
npm run dev
or
yarn dev


Open http://localhost:3000 in your browser.
🎮 Usage
Map Navigation
Pan: Click and drag
Zoom: Scroll or use the zoom controls
Rotate: Right-click and drag
Reset View: Press Ctrl+Q
Features
Search locations using the search bar
Toggle between street and satellite view
View 3D buildings in street view mode (zoom level 15+)
Check weather information (zoom level 14+)
Get current location with one click
Copy coordinates to clipboard
🛠️ Built With
Next.js 15 - React Framework
TypeScript - Type Safety
Mapbox GL JS - Maps API
Tailwind CSS - Styling
shadcn/ui - UI Components
React Map GL - React wrapper for Mapbox GL
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.