Free & open-source, ready-to-use, customizable map components for React.
Zero config. One command setup. Built on AMap (高德地图), styled with Tailwind, works seamlessly with shadcn/ui.
Get Started · Installation · Components
- 🎨 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
- 🗺️ AMap powered — Full access to AMap's powerful mapping capabilities for China
- 🧩 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
This project uses AMap (高德地图) JS API.
- API Key: You need to apply for an AMap API Key at the AMap Developer Platform.
- Commercial use: Please review AMap's Terms of Service for commercial licensing details.
- Non-commercial use: AMap provides a free tier for developers. See the developer pricing page for details.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
MIT License - see the LICENSE file for details.
Inspired by mapcn's excellent design, component patterns, and documentation structure. ai-map follows a similar approach adapted for AMap and the China mapping ecosystem.