What is mapbox-rotate-map-based-on-mobile-web-browser-compass?

This project lets you rotate a Mapbox map based on which direction your phone is pointing. When you tilt or turn your mobile device, the map automatically rotates to match your phone's compass heading, creating an immersive, real-world navigation experience. Here's how it works: your phone's built-in compass and motion sensors constantly track which direction it's facing. The code listens to these sensor readings through your mobile browser and feeds that directional information to Mapbox, which rotates the map in real time. The rotation happens smoothly thanks to an easing function that makes the motion feel natural rather than janky. The code also handles different browser quirks, Safari reports compass data slightly differently than Chrome or Firefox, so the script detects which browser you're on and reads the compass value accordingly. This is useful for anyone building mobile-first maps or navigation apps. Imagine a hiking app where rotating your phone automatically spins the map to match your real-world orientation, or a real estate app that lets you point your phone at a property and see it labeled on the map. It's also handy for augmented reality-style experiences where the digital map should feel anchored to the physical world around you. The main constraint is that this feature only works on mobile devices with compass sensors and browsers that support the Device Orientation API. Older phones or browsers without this API will show an alert instead of silently failing. It's a nice progressive enhancement, works beautifully on modern smartphones, but degrades gracefully elsewhere.