🗺️ amapcn for China! 🇨🇳

Beautiful maps for China, made simple. 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.

🧩 Using with shadcn/ui

Add amapcn components to your project using the shadcn/ui CLI:

npx shadcn@latest add https://map.ling.pub/r/amap.json

✨ 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
🗺️ 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

📜 AMap Terms of Service

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.

🤝 Contributing

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

📄 License

MIT License - see the LICENSE file for details.

Inspired by mapcn's excellent design, component patterns, and documentation structure. amapcn follows a similar approach adapted for AMap and the China mapping ecosystem.

发一个高德地图的 shadcn 组件封装