https://github.com/mburumaxwell/unlocode
Toolkit for UN/LOCODE: search, API, & react component
https://github.com/mburumaxwell/unlocode
locode unlocode
Last synced: 2 months ago
JSON representation
Toolkit for UN/LOCODE: search, API, & react component
- Host: GitHub
- URL: https://github.com/mburumaxwell/unlocode
- Owner: mburumaxwell
- License: agpl-3.0
- Created: 2026-02-24T14:10:59.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-26T17:53:25.000Z (3 months ago)
- Last Synced: 2026-03-27T07:25:22.278Z (3 months ago)
- Topics: locode, unlocode
- Language: TypeScript
- Homepage: https://unlocode.vercel.app
- Size: 5.37 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# unlocode
`unlocode` aims to make official UNECE UN/LOCODE data easy to use in real applications by providing a clean search experience, a simple public API, and reusable React UI primitives, while keeping the dataset refresh process automated and transparent.
Use the live site for the full experience, docs, and API reference: [unlocode.vercel.app](https://unlocode.vercel.app).
## What You Get
- Search UI for UN/LOCODE entries (country, function, and text filters)
- Public REST API for search, lookup, and dataset metadata
- Reusable React component (`UnlocodeInput`) for forms
- Data pipeline scripts to download and convert official UNECE CSV files
## Local Development
Use the Node version from [`.nvmrc`](./.nvmrc) before installing dependencies or running scripts:
```bash
nvm use
corepack enable
pnpm install
pnpm dev
```
Common commands:
```bash
pnpm lint
pnpm test
pnpm data:refresh
```
## Data Refresh
The dataset is generated from official UNECE source files.
```bash
pnpm data:download
pnpm data:convert
```
Or run both in sequence:
```bash
pnpm data:refresh
```