Korea Bank Icons 🇰🇷

Korean financial institution icons (banks & securities) for Flutter.

한국 은행 및 증권사 아이콘을 제공하는 Flutter 패키지입니다. 금융결제원(KFTC) 기관코드를 기반으로 합니다.

✨ Features

• 🏦 29개 은행 아이콘 지원
• 📈 25개 증권사 아이콘 지원
• 🎨 SVG 벡터 아이콘 (고해상도 지원)
• 🔢 금융결제원 표준 기관코드 사용
• 📦 간편한 API

📦 Installation

dependencies:
  korea_bank_icons: ^1.0.0

flutter pub get

🚀 Usage

Basic Usage

import 'package:korea_bank_icons/korea_bank_icons.dart';

// 아이콘 위젯 가져오기
KoreaBankIcons.getIcon('088')  // 신한은행
KoreaBankIcons.getIcon('004')  // KB국민은행

// 사이즈 조절
KoreaBankIcons.getIcon('088', size: 48)

// 색상 변경 (단색 아이콘용)
KoreaBankIcons.getIcon('088', color: Colors.blue)

Get Bank Name

KoreaBankIcons.getName('088');  // '신한은행'
KoreaBankIcons.getName('278');  // '신한금융투자'

Check Institution Type

KoreaBankIcons.isBank('088');       // true (은행)
KoreaBankIcons.isSecurities('278'); // true (증권사)

Using Code Constants

import 'package:korea_bank_icons/korea_bank_icons.dart';

// 코드 상수 사용
KoreaBankIcons.getIcon(BankCodes.shinhan);     // 신한은행
KoreaBankIcons.getIcon(BankCodes.kb);          // KB국민은행
KoreaBankIcons.getIcon(BankCodes.kiwoom);      // 키움증권

Get All Institutions

// 전체 은행 목록
final allBanks = KoreaBankIcons.banks;
// {'002': 'KDB산업은행', '003': 'IBK기업은행', ...}

// 전체 증권사 목록
final allSecurities = KoreaBankIcons.securities;
// {'209': '유안타증권', '218': 'KB증권', ...}

// 전체 금융기관
final all = KoreaBankIcons.all;

Custom SVG Usage

// Asset 경로 직접 가져오기
final path = KoreaBankIcons.getAssetPath('088');
// 'packages/korea_bank_icons/assets/icons/088.svg'

// SvgPicture 직접 사용
SvgPicture.asset(
  path!,
  width: 32,
  height: 32,
);

🏦 Supported Banks (은행)

Code	Name	Code	Name
002	KDB산업은행	003	IBK기업은행
004	KB국민은행	007	수협은행
011	NH농협은행	020	우리은행
023	SC제일은행	027	씨티은행
031	대구은행	032	부산은행
034	광주은행	035	제주은행
037	전북은행	039	경남은행
045	새마을금고	048	신협
050	저축은행	054	HSBC
055	도이치은행	060	BOA
062	중국공상은행	063	중국건설은행
064	산림조합	071	우체국
081	하나은행	088	신한은행
089	케이뱅크	090	카카오뱅크
092	토스뱅크

📈 Supported Securities (증권사)

Code	Name	Code	Name
209	유안타증권	218	KB증권
238	미래에셋증권	240	삼성증권
243	한국투자증권	247	NH투자증권
261	교보증권	262	하이투자증권
263	현대차증권	264	키움증권
265	이베스트투자증권	266	SK증권
267	대신증권	269	한화투자증권
270	하나금융투자	271	토스증권
278	신한금융투자	279	DB금융투자
280	유진투자증권	287	메리츠증권
288	카카오페이증권	290	부국증권
291	신영증권	292	케이프투자증권
294	한국포스증권

📋 Code Reference

금융결제원(KFTC) 기관코드를 사용합니다.

• 은행: 001 ~ 099
• 증권사: 200 ~ 299

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Icons are based on official financial institution logos
• Institution codes follow KFTC (Korea Financial Telecommunications & Clearings Institute) standards