Contributing to LocaleDB

LocaleDB is an open-source project and we love contributions from developers worldwide!

Fix Data

Correct typos or update outdated locale information.

Add Country

Add missing countries using standard codes.

Improve Code

Enhance the UI, search, or build scripts.

Data Contribution Workflow

Fork & Setup

Fork the GitHub repository and clone it to your local machine.

Use Data Overrides

To fix data, do not edit the generated files in /data/countries/. Instead, create or edit a file in /data/overrides/XX.json (where XX is the country code).

// data/overrides/TR.json
{
  "currency": {
    "symbolPosition": "before"
  }
}

Verify & Submit

Run the build script to verify your changes are merged correctly. Then submit a Pull Request with references to official sources.

npm run build:data

Guidelines

Pull Requests

• One change per PR
• Clear, descriptive commit messages
• Link to official sources (CLDR, Gov sites)

Resources

• CLDR Repository
• mledoze/countries
• ISO 3166 Standards

Need Help?

Have a question or stuck on a step? Start a discussion on GitHub.

Join Discussion