anmolsaini16/mapcn

맵 CN

React용 무료 및 오픈소스, 즉시 사용 가능하고 사용자 지정 가능한 지도 컴포넌트입니다.
설정 제로. 명령어 설정 하나. MapLibre GL로 빌드되었고, Tailwind 스타일로 만들어졌으며, shadcn/ui와 원활하게 작동합니다.

시작하기 · 설치 · 구성 요소

특징

• 🎨 테마 인식 — 밝음/어둠 모드에 자동으로 적응함
• 🎯 제로 설정 — 합리적인 기본값으로 바로 작동합니다
• 📦 shadcn/UI 호환 — 동일한 패턴과 스타일링 규칙을 사용합니다
• 🗺️ MapLibre GL 기반 — MapLibre의 강력한 지도 기능에 완전 접근
• 🧩 Composable — 단순하고 선언적인 구성 요소로 복잡한 지도 UI를 구축합니다
• 📍 마커 및 팝업 — 팝업, 툴팁, 라벨이 포함된 풍부한 마커 시스템
• 🛤️ Routes — 지도에 경로와 경로를 그려
• 🎮 컨트롤 — 줌, 나침반, 위치 추적, 전체 화면 제어

에이전트 스킬

코딩 에이전트(Claude Code, 커서, Codex 등)에게 mapcn 사용법을 가르치세요:

그다음 지도를 요청하거나, 앱 내 어디에 배치할지 물어보세요. mapcn.dev/docs/skill 참고하세요.

기본 지도 서비스 약관

mapcn은 기본 스타일과 예제로 OpenStreetMap 데이터를 기반으로 한 CARTO 베이스맵을 사용합니다.

mapcn

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.

Get Started · Installation · Components

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

Agent Skill

Teach your coding agent (Claude Code, Cursor, Codex, …) how to use mapcn:

npx skills add AnmolSaini16/mapcn

Then ask for a map, or ask where one would fit in your app. See mapcn.dev/docs/skill.

Basemap Terms of Service

mapcn uses CARTO Basemaps powered by OpenStreetMap data for its default styles and examples.

CARTO offers free tiers for commercial and non-commercial usage, subject to monthly tile request limits and attribution requirements.

• Commercial use: Free up to 1 million tile requests per month.
• Non-commercial use: Free up to 5 million tile requests per month.
• Attribution: CARTO and OpenStreetMap attribution must remain visible.
• API keys: CARTO requires API keys for raster basemaps and may extend this requirement to vector basemaps.

For production applications, review CARTO’s terms and configure your own basemap provider or API key as needed.

mapcn is built on MapLibre and supports alternative MapLibre-compatible basemap providers.

Sponsors

mapcn is free and open source, kept going by its sponsors. Want your logo here? See mapcn.dev/sponsors.

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)