{"_id":"@apt.today/react-korea-icons","_rev":"7-4eb387f16f5e9ef9177c518cc77c1b14","name":"@apt.today/react-korea-icons","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"@apt.today/react-korea-icons","version":"1.0.0","keywords":["react","korea","seoul","icons","svg","components","시도","시군구","광역자치단체","기초자치단체","서울","경기","부산","대구","인천","울산","행정구역","아이콘"],"author":{"name":"Chul-won Kim","email":"riky@handmade.software"},"license":"SEE LICENSE IN LICENSE","_id":"@apt.today/react-korea-icons@1.0.0","maintainers":[{"name":"myriky","email":"riky@handmade.software"}],"homepage":"https://myriky.github.io/apt-today-react-korea-icons/","bugs":{"url":"https://github.com/myriky/apt-today-react-korea-icons/issues"},"dist":{"shasum":"09787c78976e76e304a3935b0bb6c512a5e39286","tarball":"https://registry.npmjs.org/@apt.today/react-korea-icons/-/react-korea-icons-1.0.0.tgz","fileCount":9,"integrity":"sha512-3/u6ufgncuiu7wWr3xm/3ZVAMf1f0e80kQBB2mUReBsxjfUdvvCnKvLG5bvp7ebKUzkwVPkV+BI/oKGtQD0k/w==","signatures":[{"sig":"MEYCIQCCQNbb7qVLQv7XLFBTQubPveZoQh+U7K5/RNKsw4jocQIhAOJsmAJqe2INBdYZLK43E3ZeabwKhBc1k9u9ycl5WmUu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19934175},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"aa91bb5c44473a338d82ef431a4387c509cf0951","scripts":{"dev":"tsup --watch","build":"tsup","prepare":"yarn build"},"_npmUser":{"name":"myriky","email":"riky@handmade.software"},"repository":{"url":"git+https://github.com/myriky/apt-today-react-korea-icons.git","type":"git"},"_npmVersion":"10.9.0","description":"대한민국 광역자치단체(시/도) 및 기초자치단체(시/군/구) 로고 아이콘 React 컴포넌트 라이브러리","directories":{},"_nodeVersion":"22.12.0","_hasShrinkwrap":false,"packageManager":"yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e","devDependencies":{"tsup":"^8.0.1","react":"^18.2.0","typescript":"^5.3.3","@types/react":"^18.2.45"},"peerDependencies":{"react":">=17.0.0"},"_npmOperationalInternal":{"tmp":"tmp/react-korea-icons_1.0.0_1773832922070_0.43703388516337505","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@apt.today/react-korea-icons","version":"1.0.1","keywords":["react","korea","seoul","icons","svg","components","시도","시군구","광역자치단체","기초자치단체","서울","경기","부산","대구","인천","울산","행정구역","아이콘"],"author":{"name":"Chul-won Kim","email":"riky@handmade.software"},"license":"SEE LICENSE IN LICENSE","_id":"@apt.today/react-korea-icons@1.0.1","maintainers":[{"name":"myriky","email":"riky@handmade.software"}],"homepage":"https://myriky.github.io/apt-today-react-korea-icons/","bugs":{"url":"https://github.com/myriky/apt-today-react-korea-icons/issues"},"dist":{"shasum":"225050b240555380166dee31831bccb957943792","tarball":"https://registry.npmjs.org/@apt.today/react-korea-icons/-/react-korea-icons-1.0.1.tgz","fileCount":9,"integrity":"sha512-NwQ7RGd9ln+k62rjiMVV1EgG91Pzo8gs0ANGBHgnLMbUsPPKzlSwznAEYOOYs/5anZbzaedPHXmpI615bh1uWA==","signatures":[{"sig":"MEYCIQDGSys+mhONdGXq+T8SAvV8vKPQL7CL0TZXFxbKBliGzAIhAPNNsxkuWDl5ZjrF1+JY4GQBfhsobqkA7mM8oMryxERI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20236073},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"b421da39861b32cb79f2c249e4cf930f40406a42","scripts":{"dev":"tsup --watch","build":"tsup","prepare":"yarn build"},"_npmUser":{"name":"myriky","email":"riky@handmade.software"},"repository":{"url":"git+https://github.com/myriky/apt-today-react-korea-icons.git","type":"git"},"_npmVersion":"10.9.0","description":"대한민국 광역자치단체(시/도) 및 기초자치단체(시/군/구) 로고 아이콘 React 컴포넌트 라이브러리","directories":{},"_nodeVersion":"22.12.0","_hasShrinkwrap":false,"packageManager":"yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e","devDependencies":{"tsup":"^8.0.1","react":"^18.2.0","typescript":"^5.3.3","@types/react":"^18.2.45"},"peerDependencies":{"react":">=17.0.0"},"_npmOperationalInternal":{"tmp":"tmp/react-korea-icons_1.0.1_1773893999777_0.6194693124205681","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@apt.today/react-korea-icons","version":"1.0.2","keywords":["react","korea","seoul","icons","svg","components","시도","시군구","광역자치단체","기초자치단체","서울","경기","부산","대구","인천","울산","행정구역","아이콘"],"author":{"name":"Chul-won Kim","email":"riky@handmade.software"},"license":"SEE LICENSE IN LICENSE","_id":"@apt.today/react-korea-icons@1.0.2","maintainers":[{"name":"myriky","email":"riky@handmade.software"}],"homepage":"https://myriky.github.io/apt-today-react-korea-icons/","bugs":{"url":"https://github.com/myriky/apt-today-react-korea-icons/issues"},"dist":{"shasum":"10e7a3e7c22f38ce74a86e7cff39eecadbcd4138","tarball":"https://registry.npmjs.org/@apt.today/react-korea-icons/-/react-korea-icons-1.0.2.tgz","fileCount":9,"integrity":"sha512-apmM3e1D2U/Rtk8qezRl2C0anx49mnkYc5Z0GS00j1JFeEHcsPMrwJhbWNzLZE86/ft82y03p3zfsSpFuT9TIA==","signatures":[{"sig":"MEUCIDzvp68zxXe58gyb9+bNwvVrukF2BPb0mvwUp09lBuuWAiEAkyjkEjyAYfu4ketJ4bN/wV7WRYuI0ETA0+qpsb8uL+4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20235894},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"c3a2e69b880490b6a582d9ae0631c86d0eb5dff3","scripts":{"dev":"tsup --watch","build":"tsup","prepare":"yarn build"},"_npmUser":{"name":"myriky","email":"riky@handmade.software"},"repository":{"url":"git+https://github.com/myriky/apt-today-react-korea-icons.git","type":"git"},"_npmVersion":"10.9.0","description":"대한민국 광역자치단체(시/도) 및 기초자치단체(시/군/구) 로고 아이콘 React 컴포넌트 라이브러리","directories":{},"_nodeVersion":"22.12.0","_hasShrinkwrap":false,"packageManager":"yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e","devDependencies":{"tsup":"^8.0.1","react":"^18.2.0","typescript":"^5.3.3","@types/react":"^18.2.45"},"peerDependencies":{"react":">=17.0.0"},"_npmOperationalInternal":{"tmp":"tmp/react-korea-icons_1.0.2_1773980607964_0.7466987289359004","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@apt.today/react-korea-icons","version":"1.0.3","keywords":["react","korea","seoul","icons","svg","components","시도","시군구","광역자치단체","기초자치단체","서울","경기","부산","대구","인천","울산","행정구역","아이콘"],"author":{"name":"Chul-won Kim","email":"riky@handmade.software"},"license":"SEE LICENSE IN LICENSE","_id":"@apt.today/react-korea-icons@1.0.3","maintainers":[{"name":"myriky","email":"riky@handmade.software"}],"homepage":"https://myriky.github.io/apt-today-react-korea-icons/","bugs":{"url":"https://github.com/myriky/apt-today-react-korea-icons/issues"},"dist":{"shasum":"181c998394aebab4f2fee3622be824eeab162230","tarball":"https://registry.npmjs.org/@apt.today/react-korea-icons/-/react-korea-icons-1.0.3.tgz","fileCount":9,"integrity":"sha512-ImOPjawO5mxIhIdRNvVLKQh9AG5RMU++8xPkWb+hCIcbOgF4pMxAaYDXLW3HAmlT9un8cXOJ5ACfZJvCbsNE2A==","signatures":[{"sig":"MEUCIHhuRH83VgM/XZh+bkrswJjqCHl4FLo83AqKMq+zrCLlAiEAvcXU164PIwr3RXinCcJ8HF9D02TFMMhZZ7KW72KoLYQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20282376},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"1814fe72478bd62438af5deaa11fdb92d630bca7","scripts":{"dev":"tsup --watch","build":"tsup","prepare":"yarn build"},"_npmUser":{"name":"myriky","email":"riky@handmade.software"},"repository":{"url":"git+https://github.com/myriky/apt-today-react-korea-icons.git","type":"git"},"_npmVersion":"10.9.0","description":"대한민국 광역자치단체(시/도) 및 기초자치단체(시/군/구) 로고 아이콘 React 컴포넌트 라이브러리","directories":{},"_nodeVersion":"22.12.0","_hasShrinkwrap":false,"packageManager":"yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e","devDependencies":{"tsup":"^8.0.1","react":"^18.2.0","typescript":"^5.3.3","@types/react":"^18.2.45"},"peerDependencies":{"react":">=17.0.0"},"_npmOperationalInternal":{"tmp":"tmp/react-korea-icons_1.0.3_1777876634704_0.5156516662726063","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@apt.today/react-korea-icons","version":"1.1.1","description":"대한민국 광역자치단체(시/도) 및 기초자치단체(시/군/구) 로고 아이콘 React 컴포넌트 라이브러리","main":"./dist/index.js","module":"./dist/index.mjs","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"build":"tsup","dev":"tsup --watch","prepare":"yarn build"},"keywords":["react","korea","seoul","icons","svg","components","시도","시군구","광역자치단체","기초자치단체","서울","경기","부산","대구","인천","울산","행정구역","아이콘"],"author":{"name":"Chul-won Kim","email":"riky@handmade.software"},"license":"SEE LICENSE IN LICENSE","peerDependencies":{"react":">=18.0.0"},"devDependencies":{"@types/react":"^18.2.45","react":"^18.2.0","react-dom":"^18.2.0","tsup":"^8.0.1","typescript":"^5.3.3"},"repository":{"type":"git","url":"git+https://github.com/myriky/apt-today-react-korea-icons.git"},"homepage":"https://myriky.github.io/apt-today-react-korea-icons/","packageManager":"yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e","_id":"@apt.today/react-korea-icons@1.1.1","gitHead":"b76fcca2511e2399bd1627473dfec4a9c4eb9a99","bugs":{"url":"https://github.com/myriky/apt-today-react-korea-icons/issues"},"_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-EOL0wGXVJmp00z6cX7+jn0EDpvzJvBrSG/SM7cAVnO2TySEFffr55v7A1+3BZw0o+xRIMkGylBer+/ehmoHGVA==","shasum":"6d500bca2fcb734e9c103a8b3be513478bb4e882","tarball":"https://registry.npmjs.org/@apt.today/react-korea-icons/-/react-korea-icons-1.1.1.tgz","fileCount":9,"unpackedSize":20495844,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHCBZTIoRwXasCauRjUYH90JWqtG2knf7EgeVXbI9LQtAiAW1kRqxpL8zO9a9br2PDR1B0Fe8kA6IpiAiPwZ/d9McQ=="}]},"_npmUser":{"name":"myriky","email":"riky@handmade.software"},"directories":{},"maintainers":[{"name":"myriky","email":"riky@handmade.software"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/react-korea-icons_1.1.1_1783481091289_0.725885153432835"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T11:22:02.006Z","modified":"2026-07-08T03:24:51.723Z","1.0.0":"2026-03-18T11:22:02.406Z","1.0.1":"2026-03-19T04:20:00.161Z","1.0.2":"2026-03-20T04:23:28.295Z","1.0.3":"2026-05-04T06:37:15.044Z","1.1.0":"2026-07-07T12:23:48.810Z","1.1.1":"2026-07-08T03:24:51.609Z"},"bugs":{"url":"https://github.com/myriky/apt-today-react-korea-icons/issues"},"author":{"name":"Chul-won Kim","email":"riky@handmade.software"},"license":"SEE LICENSE IN LICENSE","homepage":"https://myriky.github.io/apt-today-react-korea-icons/","keywords":["react","korea","seoul","icons","svg","components","시도","시군구","광역자치단체","기초자치단체","서울","경기","부산","대구","인천","울산","행정구역","아이콘"],"repository":{"type":"git","url":"git+https://github.com/myriky/apt-today-react-korea-icons.git"},"description":"대한민국 광역자치단체(시/도) 및 기초자치단체(시/군/구) 로고 아이콘 React 컴포넌트 라이브러리","maintainers":[{"name":"myriky","email":"riky@handmade.software"}],"readme":"# @apt.today/react-korea-icons\n\n[![npm version](https://img.shields.io/npm/v/@apt.today/react-korea-icons.svg?style=flat-square)](https://www.npmjs.com/package/@apt.today/react-korea-icons)\n[![npm downloads](https://img.shields.io/npm/dm/@apt.today/react-korea-icons.svg?style=flat-square)](https://www.npmjs.com/package/@apt.today/react-korea-icons)\n[![GitHub stars](https://img.shields.io/github/stars/myriky/apt-today-react-korea-icons.svg?style=flat-square)](https://github.com/myriky/apt-today-react-korea-icons)\n[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg?style=flat-square)](https://www.typescriptlang.org/)\n[![License](https://img.shields.io/badge/License-Custom-orange.svg?style=flat-square)](./LICENSE)\n\n대한민국 17개 광역자치단체 CI + 226개 기초자치단체 공식 로고를 React 컴포넌트로 제공합니다.\n\n![react-korea-icons preview](./assets/preview.png)\n\n[데모 페이지](https://myriky.github.io/apt-today-react-korea-icons/)\n\n> 이전 패키지명 `@apt.today/react-seoul-icons`에서 전국 확장에 맞춰 이름을 변경했습니다.\n\n## 설치\n\n```bash\nnpm install @apt.today/react-korea-icons\n```\n\n```bash\nyarn add @apt.today/react-korea-icons\n```\n\n## 사용법\n\n### 컴포넌트 직접 사용\n\n```tsx\nimport { GangnamGu, Seoul, Busan, HaeundaeGu } from \"@apt.today/react-korea-icons\";\n\nfunction App() {\n  return (\n    <div>\n      <Seoul width={64} height={64} />\n      <GangnamGu className=\"w-12 h-12\" />\n      <Busan style={{ width: 48, height: 48 }} />\n      <HaeundaeGu width={48} height={48} />\n    </div>\n  );\n}\n```\n\n### 유틸리티로 동적 조회\n\n코드나 이름으로 아이콘을 동적으로 가져올 때는 `utils`를 사용합니다.\n\n```tsx\nimport { utils } from \"@apt.today/react-korea-icons\";\n\n// 코드로 아이콘 가져오기 (시도 2자리 / 시군구 5자리 자동 판별)\nconst SeoulIcon = utils.getIcon(11);      // 서울특별시\nconst GangnamIcon = utils.getIcon(11680); // 강남구\n\n// 이름으로 아이콘 검색\nconst Icon = utils.findByName(\"강남구\");\nconst Icon2 = utils.findByName(\"해운대구\");\n\n// 중복 이름(중구, 동구 등)은 region 옵션으로 구분\nconst JungGu = utils.findByName(\"중구\", { region: \"서울\" });\nconst BusanDongGu = utils.findByName(\"동구\", { region: \"부산\" });\n```\n\n### 지역별 목록 조회\n\n```tsx\nimport { utils } from \"@apt.today/react-korea-icons\";\n\n// 시도별 시군구 목록\nconst seoulIcons = utils.getByRegion(11);      // 코드로\nconst busanIcons = utils.getByRegion(\"부산\");   // 이름으로\n\n// 전체 시도 목록 (17개)\nconst regions = utils.getAllRegions();\n\n// 전체 시군구 아이콘 목록 (210개)\nconst allIcons = utils.getAll();\n\nfunction DistrictList() {\n  return (\n    <div className=\"grid grid-cols-5 gap-4\">\n      {busanIcons.map((icon) => (\n        <div key={icon.code} className=\"flex flex-col items-center\">\n          <icon.component className=\"w-12 h-12\" />\n          <span>{icon.name}</span>\n        </div>\n      ))}\n    </div>\n  );\n}\n```\n\n### API 응답에서 동적으로 사용\n\n```tsx\nimport { utils } from \"@apt.today/react-korea-icons\";\n\n// 행정구역 코드를 받은 경우\nfunction DistrictIcon({ code }: { code: number }) {\n  const Icon = utils.getIcon(code);\n  if (!Icon) return null;\n  return <Icon width={48} height={48} />;\n}\n```\n\n## API\n\n### 아이콘 컴포넌트\n\n모든 아이콘 컴포넌트는 `React.SVGProps<SVGSVGElement>`를 지원합니다.\n\n```tsx\n<GangnamGu width={48} height={48} />\n<GangnamGu className=\"w-12 h-12\" />\n<GangnamGu style={{ width: 48 }} />\n```\n\n### utils\n\n| 메서드 | 설명 | 반환 타입 |\n| --- | --- | --- |\n| `utils.getIcon(code)` | 시도/시군구 코드로 아이콘 가져오기 | `IconComponent \\| null` |\n| `utils.findByName(name, options?)` | 이름으로 아이콘 검색 | `IconComponent \\| null` |\n| `utils.getInfo(code)` | 코드로 상세 정보 가져오기 | `IconInfo \\| RegionInfo \\| null` |\n| `utils.getByRegion(codeOrName)` | 특정 시도의 시군구 목록 | `IconInfo[]` |\n| `utils.getAllRegions()` | 모든 시도 정보 | `RegionInfo[]` |\n| `utils.getAvailableRegions()` | 아이콘이 있는 시도만 | `RegionInfo[]` |\n| `utils.getRegionsWithIcons()` | 시군구가 있는 시도만 | `RegionInfo[]` |\n| `utils.getAll()` | 모든 시군구 아이콘 정보 | `IconInfo[]` |\n| `utils.isValid(code)` | 유효한 코드인지 확인 | `boolean` |\n\n### 타입\n\n```tsx\nimport type { IconComponent, IconInfo, RegionInfo } from \"@apt.today/react-korea-icons\";\n\n// IconComponent\ntype IconComponent = React.ComponentType<React.SVGProps<SVGSVGElement>>;\n\n// IconInfo - 시군구 아이콘 정보\ninterface IconInfo {\n  code: number;          // 시군구 코드 (예: 11680)\n  regionCode: number;    // 소속 시도 코드 (예: 11)\n  regionName: string;    // 소속 시도명 (예: \"서울특별시\")\n  name: string;          // 이름 (예: \"강남구\")\n  shortName: string;     // 단축명 (예: \"강남\")\n  componentName: string; // 컴포넌트명 (예: \"GangnamGu\")\n  component: IconComponent;\n}\n\n// RegionInfo - 시도 정보\ninterface RegionInfo {\n  code: number;               // 시도 코드 (예: 11)\n  name: string;               // 전체 이름 (예: \"서울특별시\")\n  shortName: string;          // 단축명 (예: \"서울\")\n  englishName: string;        // 영문명 (예: \"Seoul\")\n  component: IconComponent | null;\n}\n```\n\n## SSR / 다중 인스턴스 안전성\n\n이 패키지의 모든 컴포넌트는 SSR 환경에서 안전하게 동작합니다.\n\n- `renderToStaticMarkup`을 컴포넌트당 별도로 여러 번 호출해도 ID 충돌 없음\n- Next.js App Router의 서버 컴포넌트와 client component hydration에서 mismatch warning 없음\n- 지도 마커처럼 같은 컴포넌트를 한 화면에 N개 띄워도 그라디언트가 정상 렌더\n\n> 내부 구현: 변환 가능한 컴포넌트는 `<defs>`/`<clipPath>` 정의를 path 좌표에 인라인화하고, 그라디언트 정의가 필요한 컴포넌트는 컴포넌트명 기반 hardcoded prefix(예: `kicon-yonginsi-b`)를 사용합니다. 같은 컴포넌트의 여러 인스턴스는 같은 ID를 공유하지만 정의가 동일하므로 시각적으로 무해하고, `React.useId()`가 만드는 hydration 의존성을 제거해 SSR/CSR 어느 환경에서나 결정적입니다.\n\n## 지원 행정구역\n\n17개 광역자치단체 CI + 226개 기초자치단체 로고\n\n> 행정구역 코드는 [법정동코드](https://www.code.go.kr) 기준입니다.\n\n| 시도 | 코드 | 컴포넌트명 | 시군구 |\n| --- | --- | --- | --- |\n| 서울특별시 | `11` | `Seoul` | 25개 |\n| 부산광역시 | `26` | `Busan` | 16개 |\n| 대구광역시 | `27` | `Daegu` | 9개 |\n| 인천광역시 | `28` | `Incheon` | 10개 |\n| 광주광역시 | `29` | `Gwangju` | 5개 |\n| 대전광역시 | `30` | `Daejeon` | 5개 |\n| 울산광역시 | `31` | `Ulsan` | 5개 |\n| 세종특별자치시 | `36` | `Sejong` | - |\n| 경기도 | `41` | `Gyeonggi` | 31개 |\n| 강원특별자치도 | `51` | `Gangwon` | 18개 |\n| 충청북도 | `43` | `Chungbuk` | 11개 |\n| 충청남도 | `44` | `Chungnam` | 15개 |\n| 전북특별자치도 | `52` | `Jeonbuk` | 14개 |\n| 전라남도 | `46` | `Jeonnam` | 22개 |\n| 경상북도 | `47` | `Gyeongbuk` | 22개 |\n| 경상남도 | `48` | `Gyeongnam` | 18개 |\n| 제주특별자치도 | `50` | `Jeju` | - |\n\n### 시군구 상세 코드\n\n<details>\n<summary><strong>서울특별시</strong> (코드: 11) — 25개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `11110` | 종로구 | `JongnoGu` |\n| `11140` | 중구 | `JungGu` |\n| `11170` | 용산구 | `YongsanGu` |\n| `11200` | 성동구 | `SeongdongGu` |\n| `11215` | 광진구 | `GwangjinGu` |\n| `11230` | 동대문구 | `DongdaemunGu` |\n| `11260` | 중랑구 | `JungnangGu` |\n| `11290` | 성북구 | `SeongbukGu` |\n| `11305` | 강북구 | `GangbukGu` |\n| `11320` | 도봉구 | `DobongGu` |\n| `11350` | 노원구 | `NowonGu` |\n| `11380` | 은평구 | `EunpyeongGu` |\n| `11410` | 서대문구 | `SeodaemunGu` |\n| `11440` | 마포구 | `MapoGu` |\n| `11470` | 양천구 | `YangcheonGu` |\n| `11500` | 강서구 | `GangseoGu` |\n| `11530` | 구로구 | `GuroGu` |\n| `11545` | 금천구 | `GeumcheonGu` |\n| `11560` | 영등포구 | `YeongdeungpoGu` |\n| `11590` | 동작구 | `DongjakGu` |\n| `11620` | 관악구 | `GwanakGu` |\n| `11650` | 서초구 | `SeochoGu` |\n| `11680` | 강남구 | `GangnamGu` |\n| `11710` | 송파구 | `SongpaGu` |\n| `11740` | 강동구 | `GangdongGu` |\n\n</details>\n\n<details>\n<summary><strong>부산광역시</strong> (코드: 26) — 16개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `26110` | 중구 | `BusanJungGu` |\n| `26140` | 서구 | `BusanSeoGu` |\n| `26170` | 동구 | `BusanDongGu` |\n| `26200` | 영도구 | `YeongdoGu` |\n| `26230` | 부산진구 | `BusanjinGu` |\n| `26260` | 동래구 | `DongnaeGu` |\n| `26290` | 남구 | `BusanNamGu` |\n| `26320` | 북구 | `BusanBukGu` |\n| `26350` | 해운대구 | `HaeundaeGu` |\n| `26380` | 사하구 | `SahaGu` |\n| `26410` | 금정구 | `GeumjeongGu` |\n| `26440` | 강서구 | `BusanGangseoGu` |\n| `26470` | 연제구 | `YeonjeGu` |\n| `26500` | 수영구 | `SuyeongGu` |\n| `26530` | 사상구 | `SasangGu` |\n| `26710` | 기장군 | `GijangGun` |\n\n</details>\n\n<details>\n<summary><strong>대구광역시</strong> (코드: 27) — 9개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `27110` | 중구 | `DaeguJungGu` |\n| `27140` | 동구 | `DaeguDongGu` |\n| `27170` | 서구 | `DaeguSeoGu` |\n| `27200` | 남구 | `DaeguNamGu` |\n| `27230` | 북구 | `DaeguBukGu` |\n| `27260` | 수성구 | `SuseongGu` |\n| `27290` | 달서구 | `DalseoGu` |\n| `27710` | 달성군 | `DalseongGun` |\n| `27720` | 군위군 | `GunwiGun` |\n\n</details>\n\n<details>\n<summary><strong>인천광역시</strong> (코드: 28) — 10개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `28110` | 중구 | `IncheonJungGu` |\n| `28140` | 동구 | `IncheonDongGu` |\n| `28177` | 미추홀구 | `MichuholGu` |\n| `28185` | 연수구 | `YeonsuGu` |\n| `28200` | 남동구 | `NamdongGu` |\n| `28237` | 부평구 | `BupyeongGu` |\n| `28245` | 계양구 | `GeyangGu` |\n| `28260` | 서구 | `IncheonSeoGu` |\n| `28710` | 강화군 | `GanghwaGun` |\n| `28720` | 옹진군 | `OngjinGun` |\n\n</details>\n\n<details>\n<summary><strong>광주광역시</strong> (코드: 29) — 5개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `29110` | 동구 | `GwangjuDongGu` |\n| `29140` | 서구 | `GwangjuSeoGu` |\n| `29155` | 남구 | `GwangjuNamGu` |\n| `29170` | 북구 | `GwangjuBukGu` |\n| `29200` | 광산구 | `GwangsanGu` |\n\n</details>\n\n<details>\n<summary><strong>대전광역시</strong> (코드: 30) — 5개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `30110` | 동구 | `DaejeonDongGu` |\n| `30140` | 중구 | `DaejeonJungGu` |\n| `30170` | 서구 | `DaejeonSeoGu` |\n| `30200` | 유성구 | `YuseongGu` |\n| `30230` | 대덕구 | `DaedeokGu` |\n\n</details>\n\n<details>\n<summary><strong>울산광역시</strong> (코드: 31) — 5개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `31110` | 중구 | `UlsanJungGu` |\n| `31140` | 남구 | `UlsanNamGu` |\n| `31170` | 동구 | `UlsanDongGu` |\n| `31200` | 북구 | `UlsanBukGu` |\n| `31710` | 울주군 | `UlsanUljuGun` |\n\n</details>\n\n<details>\n<summary><strong>경기도</strong> (코드: 41) — 31개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `41110` | 수원시 | `SuwonSi` |\n| `41130` | 성남시 | `SeongnamSi` |\n| `41150` | 의정부시 | `UijeongbuSi` |\n| `41170` | 안양시 | `AnyangSi` |\n| `41190` | 부천시 | `BucheonSi` |\n| `41210` | 광명시 | `GwangmyeongSi` |\n| `41220` | 평택시 | `PyeongtaekSi` |\n| `41250` | 동두천시 | `DongducheonSi` |\n| `41270` | 안산시 | `AnsanSi` |\n| `41280` | 고양시 | `GoyangSi` |\n| `41290` | 과천시 | `GwacheonSi` |\n| `41310` | 구리시 | `GuriSi` |\n| `41360` | 남양주시 | `NamyangjuSi` |\n| `41370` | 오산시 | `OsanSi` |\n| `41390` | 시흥시 | `SiheungSi` |\n| `41410` | 군포시 | `GunpoSi` |\n| `41430` | 의왕시 | `UiwangSi` |\n| `41450` | 하남시 | `HanamSi` |\n| `41460` | 용인시 | `YonginSi` |\n| `41480` | 파주시 | `PajuSi` |\n| `41500` | 이천시 | `IcheonSi` |\n| `41550` | 안성시 | `AnseongSi` |\n| `41570` | 김포시 | `GimpoSi` |\n| `41590` | 화성시 | `HwaseongSi` |\n| `41610` | 광주시 | `GyeonggiGwangjuSi` |\n| `41630` | 양주시 | `YangjuSi` |\n| `41650` | 포천시 | `PocheonSi` |\n| `41670` | 여주시 | `YeojuSi` |\n| `41800` | 연천군 | `YeoncheonGun` |\n| `41820` | 가평군 | `GapyeongGun` |\n| `41830` | 양평군 | `YangpyeongGun` |\n\n</details>\n\n<details>\n<summary><strong>강원특별자치도</strong> (코드: 51) — 18개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `51110` | 춘천시 | `ChuncheonSi` |\n| `51130` | 원주시 | `WonjuSi` |\n| `51150` | 강릉시 | `GangneungSi` |\n| `51170` | 동해시 | `DonghaeSi` |\n| `51190` | 태백시 | `TaebaekSi` |\n| `51210` | 속초시 | `SokcheoSi` |\n| `51230` | 삼척시 | `SamcheokSi` |\n| `51720` | 홍천군 | `HongcheonGun` |\n| `51730` | 횡성군 | `HoengseongGun` |\n| `51750` | 영월군 | `YeongwolGun` |\n| `51760` | 평창군 | `PyeongchangGun` |\n| `51770` | 정선군 | `JeongseonGun` |\n| `51780` | 철원군 | `CheorwonGun` |\n| `51790` | 화천군 | `HwacheonGun` |\n| `51800` | 양구군 | `YanguGun` |\n| `51810` | 인제군 | `InjeGun` |\n| `51820` | 고성군 | `GangwonGoseongGun` |\n| `51830` | 양양군 | `YangyangGun` |\n\n</details>\n\n<details>\n<summary><strong>충청북도</strong> (코드: 43) — 11개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `43110` | 청주시 | `CheongjuSi` |\n| `43130` | 충주시 | `ChungjuSi` |\n| `43150` | 제천시 | `JecheonSi` |\n| `43720` | 보은군 | `BoeunGun` |\n| `43730` | 옥천군 | `OkcheonGun` |\n| `43740` | 영동군 | `YeongdongGun` |\n| `43745` | 증평군 | `JeungpyeongGun` |\n| `43750` | 진천군 | `JincheonGun` |\n| `43760` | 괴산군 | `GoesanGun` |\n| `43770` | 음성군 | `EumseongGun` |\n| `43800` | 단양군 | `DanyangGun` |\n\n</details>\n\n<details>\n<summary><strong>충청남도</strong> (코드: 44) — 15개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `44130` | 천안시 | `CheonanSi` |\n| `44150` | 공주시 | `GongjuSi` |\n| `44180` | 보령시 | `BoryeongSi` |\n| `44200` | 아산시 | `AsanSi` |\n| `44210` | 서산시 | `SeosanSi` |\n| `44230` | 논산시 | `NonsanSi` |\n| `44250` | 계룡시 | `GyeryongSi` |\n| `44270` | 당진시 | `DangjinSi` |\n| `44710` | 금산군 | `GeumsanGun` |\n| `44760` | 부여군 | `BuyeoGun` |\n| `44770` | 서천군 | `SeocheonGun` |\n| `44790` | 청양군 | `CheongyangGun` |\n| `44800` | 홍성군 | `HongseongGun` |\n| `44810` | 예산군 | `YesanGun` |\n| `44825` | 태안군 | `TaeanGun` |\n\n</details>\n\n<details>\n<summary><strong>전북특별자치도</strong> (코드: 52) — 14개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `52110` | 전주시 | `JeonjuSi` |\n| `52130` | 군산시 | `GunsanSi` |\n| `52140` | 익산시 | `IksanSi` |\n| `52180` | 정읍시 | `JeongeupSi` |\n| `52190` | 남원시 | `NamwonSi` |\n| `52210` | 김제시 | `GimjeSi` |\n| `52710` | 완주군 | `WanjuGun` |\n| `52720` | 진안군 | `JinanGun` |\n| `52730` | 무주군 | `MujuGun` |\n| `52740` | 장수군 | `JangsuGun` |\n| `52750` | 임실군 | `ImsilGun` |\n| `52770` | 순창군 | `SunchangGun` |\n| `52790` | 고창군 | `GochangGun` |\n| `52800` | 부안군 | `BuanGun` |\n\n</details>\n\n<details>\n<summary><strong>전라남도</strong> (코드: 46) — 22개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `46110` | 목포시 | `MokpoSi` |\n| `46130` | 여수시 | `YeosuSi` |\n| `46150` | 순천시 | `SuncheonSi` |\n| `46170` | 나주시 | `NajuSi` |\n| `46230` | 광양시 | `GwangyangSi` |\n| `46710` | 담양군 | `DamyangGun` |\n| `46720` | 곡성군 | `GokseongGun` |\n| `46730` | 구례군 | `GuryeGun` |\n| `46770` | 고흥군 | `GoheungGun` |\n| `46780` | 보성군 | `BoseongGun` |\n| `46790` | 화순군 | `HwasunGun` |\n| `46800` | 장흥군 | `JangheungGun` |\n| `46810` | 강진군 | `GangjinGun` |\n| `46820` | 해남군 | `HaenamGun` |\n| `46830` | 영암군 | `YeongamGun` |\n| `46840` | 무안군 | `MuanGun` |\n| `46860` | 함평군 | `HampyeongGun` |\n| `46870` | 영광군 | `YeonggwangGun` |\n| `46880` | 장성군 | `JangseongGun` |\n| `46890` | 완도군 | `WandoGun` |\n| `46900` | 진도군 | `JindoGun` |\n| `46910` | 신안군 | `SinanGun` |\n\n</details>\n\n<details>\n<summary><strong>경상북도</strong> (코드: 47) — 22개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `47110` | 포항시 | `PohangSi` |\n| `47130` | 경주시 | `GyeongjuSi` |\n| `47150` | 김천시 | `GimcheonSi` |\n| `47170` | 안동시 | `AndongSi` |\n| `47190` | 구미시 | `GumiSi` |\n| `47210` | 영주시 | `YeongjuSi` |\n| `47230` | 영천시 | `YeongcheonSi` |\n| `47250` | 상주시 | `SangjuSi` |\n| `47280` | 문경시 | `MungyeongSi` |\n| `47290` | 경산시 | `GyeongsanSi` |\n| `47730` | 의성군 | `UiseongGun` |\n| `47750` | 청송군 | `CheongsongGun` |\n| `47760` | 영양군 | `YeongyangGun` |\n| `47770` | 영덕군 | `YeongdeokGun` |\n| `47820` | 청도군 | `CheongdoGun` |\n| `47830` | 고령군 | `GoryeongGun` |\n| `47840` | 성주군 | `SeongjuGun` |\n| `47850` | 칠곡군 | `ChilgokGun` |\n| `47900` | 예천군 | `YecheonGun` |\n| `47920` | 봉화군 | `BonghwaGun` |\n| `47930` | 울진군 | `UljinGun` |\n| `47940` | 울릉군 | `UlleungGun` |\n\n</details>\n\n<details>\n<summary><strong>경상남도</strong> (코드: 48) — 18개</summary>\n\n| 코드 | 이름 | 컴포넌트명 |\n| --- | --- | --- |\n| `48120` | 창원시 | `ChangwonSi` |\n| `48170` | 진주시 | `JinjuSi` |\n| `48220` | 통영시 | `TongyeongSi` |\n| `48240` | 사천시 | `SacheonSi` |\n| `48250` | 김해시 | `GimhaeSi` |\n| `48270` | 밀양시 | `MiryangSi` |\n| `48310` | 거제시 | `GeojeSi` |\n| `48330` | 양산시 | `YangsanSi` |\n| `48720` | 의령군 | `UiryeongGun` |\n| `48730` | 함안군 | `HamanGun` |\n| `48740` | 창녕군 | `ChangnyeongGun` |\n| `48820` | 고성군 | `GyeongnamGoseongGun` |\n| `48840` | 남해군 | `NamhaeGun` |\n| `48850` | 하동군 | `HadongGun` |\n| `48860` | 산청군 | `SancheongGun` |\n| `48870` | 함양군 | `HamyangGun` |\n| `48880` | 거창군 | `GeochangGun` |\n| `48890` | 합천군 | `HapcheonGun` |\n\n</details>\n\n## react-seoul-icons에서 마이그레이션\n\n패키지명만 변경하면 됩니다. API는 동일합니다.\n\n```diff\n- import { GangnamGu, utils } from \"@apt.today/react-seoul-icons\";\n+ import { GangnamGu, utils } from \"@apt.today/react-korea-icons\";\n```\n\n## 라이선스\n\n### 아이콘 저작권\n\n본 라이브러리의 아이콘은 각 지방자치단체의 공식 심볼/로고로, 공공누리 제1유형(출처표시)에 따라 자유롭게 이용할 수 있습니다.\n\n### 라이브러리 코드\n\nMIT 라이선스. 자세한 내용은 [LICENSE](./LICENSE) 파일을 참고하세요.\n\n## About apt.today\n\n이 라이브러리는 [apt.today](https://apt.today) 프로젝트의 일부입니다.\n\n**apt.today**는 전국 지자체별 고시공고문, 모집공고문, 토지거래허가내역을 비롯한 다양한 아파트 관련 정보를 제공하는 플랫폼입니다.\n\n## 기여\n\n이슈 제보 및 풀 리퀘스트는 언제나 환영합니다!\n","readmeFilename":"README.md"}