Dorabot – Vietnam address after 2025 merger

@dorabot-io/dia-chi

Địa chỉ hành chính Việt Nam sau sáp nhập 2025 cho JavaScript / TypeScript: 34 tỉnh, 3.321 xã/phường/đặc khu mới, bảng đổi 11.559 xã cũ sang mới theo đúng nghị quyết của Ủy ban Thường vụ Quốc hội (kèm số khoản), và form chọn địa chỉ 2 cấp cho React.

Từ 01/7/2025 địa chỉ ở Việt Nam chỉ còn 2 cấp: xã/phường/đặc khu → tỉnh/thành phố. Không còn quận/huyện. Form 3 cấp (tỉnh → huyện → xã) là kiểu cũ.

npm i @dorabot-io/dia-chi

Chạy offline, không cần khoá, không gọi mạng (trừ doiDiaChi). Node ≥ 18, trình duyệt, Vite, Next.js, Bun, Deno, Cloudflare Workers.

Dùng nhanh

import { tinh, xa, timXaCu, kiemDiaChi, doiDiaChi } from '@dorabot-io/dia-chi';

tinh();                 // 34 tỉnh/thành: { slug, tenDayDu, gomTinhCu, nghiQuyet, soXa }
xa('ha-noi');           // xã/phường mới của Hà Nội (nhận cả "Hà Nội", "Thái Bình" → Hưng Yên)

await timXaCu('Bách Khoa', { huyen: 'Hai Bà Trưng', tinh: 'Hà Nội' });
// [{ xaCu: 'Phường Bách Khoa', huyenCu: 'Quận Hai Bà Trưng', den: [{ tenDayDu: 'Phường Bạch Mai', phan: 'toan_bo', khoan: 8 }],
//    nghiQuyet: { so: '1656/NQ-UBTVQH15', hieu_luc: '2025-07-01', url: '…' } }]

---

View the full README on GitHub