🗺️ Pathfinder

Une application de cartographie moderne et interactive construite avec Next.js 15, MapboxGL et TypeScript. Pathfinder offre une expérience cartographique fluide avec des fonctionnalités telles que les données météo en temps réel, la recherche de localisation et des styles de carte personnalisables.

Démo · Signaler un bug · Demander une fonctionnalité

✨ Fonctionnalités

🌓 Support mode sombre/clair
🏢 Visualisation de bâtiments 3D
🔍 Recherche de localisation avec autocomplétion
🌤️ Informations météorologiques en temps réel
📍 Détection de la localisation actuelle
🛰️ Bascule vue rue/satellite
📱 Design entièrement responsive
⌨️ Support des raccourcis clavier
🎨 Interface moderne avec Tailwind CSS et shadcn/ui

🚀 Pour commencer

Prérequis

Node.js 22+
Une clé API Mapbox (à obtenir sur Mapbox)
Une clé API OpenWeather (à obtenir sur OpenWeather)
npm ou yarn

Installation

Cloner le dépôt :

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

Installer les dépendances :

npm install
or
yarn install

Configurez les variables d'environnement :
Copiez le fichier .env.example vers .env.local :

     cp .env.example .env.local
     ``
   Ouvrez .env.local et ajoutez votre clé API Mapbox :

     
`env
     NEXT_PUBLIC_MAPBOX_ACCESS_TOKEN=your_mapbox_token_here
     NEXT_PUBLIC_WEATHER_API_KEY=your_weather_api_key_here
     `
   Obtenez vos clés API depuis :
     Mapbox - pour la fonctionnalité de carte
     OpenWeather - pour les données météorologiques
Démarrez le serveur de développement :

bash
npm run dev
or
yarn dev


Ouvrez http://localhost:3000 dans votre navigateur.
🎮 Utilisation
Navigation sur la carte
Panoramique : Cliquez et faites glisser
Zoom : Faites défiler ou utilisez les contrôles de zoom
Rotation : Clic droit et faites glisser
Réinitialiser la vue : Appuyez sur Ctrl+Q
Fonctionnalités
Recherchez des emplacements avec la barre de recherche
Basculez entre la vue rue et satellite
Affichez les bâtiments 3D en mode vue rue (niveau de zoom 15+)
Consultez les informations météo (niveau de zoom 14+)
Obtenez la position actuelle en un clic
Copiez les coordonnées dans le presse-papiers
🛠️ Construit avec
Next.js 15 - Framework React
TypeScript - Sécurité des types
Mapbox GL JS - API de cartes
Tailwind CSS - Stylisation
shadcn/ui - Composants UI
React Map GL - Wrapper React pour Mapbox GL
🤝 Contribution
Les contributions sont les bienvenues ! N’hésitez pas à soumettre une Pull Request. Pour les changements majeurs, veuillez d’abord ouvrir une issue pour discuter des modifications souhaitées.