A headless React hook for Turkish addresses. Province, district, and neighbourhood are picked in a chain, the postal code comes from the neighbourhood, and the address is re-checked on the server.
Türkiye only: addresses from other countries are not included.
Address line
Builds up as you pick
81 provinces · 973 districts
PTT’s address data comes included. Neighbourhoods load only for the picked province, so a typical visit is about 10 kB. The data is checked every month.
Province → district → neighbourhood
Changing the province resets the district and neighbourhood on its own. You don’t have to track which field is open or loading.
Picked or typed
Pick a neighbourhood and the postal code appears; type a postal code and the province, district and often the neighbourhood fill in. Unknown codes are refused.
Headless · shadcn · antd
Renders nothing; works with a native select, shadcn/ui, Ant Design or your own component, so the look stays yours.
İ · ı · formatAddress
Search understands Turkish letters: typing “istanbul” finds “İstanbul”. The chosen address becomes one line: “Alandüzü Mah. Adapazarı/Sakarya”.
Never trust the client
A submitted address is re-checked against the dataset on the server, and the postal code is derived there, so you never trust the client’s values.