Free & open-source, ready-to-use, customizable map components for React.
Zero config. One command setup. Built on MapLibre GL, styled with Tailwind, works seamlessly with shadcn/ui.
## Features
- ๐จ **Theme-aware** โ Automatically adapts to light/dark mode
- ๐ฏ **Zero config** โ Works out of the box with sensible defaults
- ๐ฆ **shadcn/ui compatible** โ Uses the same patterns and styling conventions
- ๐บ๏ธ **MapLibre GL powered** โ Full access to MapLibre's powerful mapping capabilities
- ๐งฉ **Composable** โ Build complex map UIs with simple, declarative components
- ๐ **Markers & Popups** โ Rich marker system with popups, tooltips, and labels
- ๐ค๏ธ **Routes** โ Draw routes and paths on your maps
- ๐ฎ **Controls** โ Zoom, compass, locate, and fullscreen controls
## Basemap Terms of Service
This project uses [CARTO Basemaps](https://docs.carto.com/faqs/carto-basemaps) which are based on OpenStreetMap data.
- **Commercial use**: Requires a CARTO Enterprise license. [Request a demo](https://carto.com/request-live-demo) for pricing details.
- **Non-commercial use**: Free for CARTO grantees under their [basemap terms](https://carto.com/legal/bmap).
- **Alternative**: You can switch to [OpenStreetMap](https://www.openstreetmap.org/) tiles or any other MapLibre-compatible tile provider (MapTiler, Stadia Maps, etc).
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
MIT License - see the [LICENSE](LICENSE) file for details.
## Star History
