{"id":24568175,"url":"https://github.com/ogubuikeAlex/CountryRegionJS","last_synced_at":"2025-10-04T18:32:33.819Z","repository":{"id":155010054,"uuid":"630934727","full_name":"ogubuikeAlex/CountryRegionJS","owner":"ogubuikeAlex","description":"CountryRegionJs is a simple-to-use library that provides you with the MOST COMPREHENSIVE cascading dropdown for loading countries, associated states and substates (local governments).","archived":false,"fork":false,"pushed_at":"2023-09-21T20:04:40.000Z","size":211,"stargazers_count":3,"open_issues_count":5,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-17T21:10:35.250Z","etag":null,"topics":["api","countries","countries-api","country","country-dropdownlist","country-state-city-dropdown","dropdown","javascript","location","nodejs","react","reactjs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ogubuikeAlex.png","metadata":{"files":{"readme":"ReadME.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE.md","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-21T13:55:45.000Z","updated_at":"2024-10-25T18:46:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"86fcf35e-3be8-4ab7-8d2e-e9229006710c","html_url":"https://github.com/ogubuikeAlex/CountryRegionJS","commit_stats":null,"previous_names":["ogubuikealex/countryregionjs","king-alex-d-great/countryregionjs"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogubuikeAlex%2FCountryRegionJS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogubuikeAlex%2FCountryRegionJS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogubuikeAlex%2FCountryRegionJS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogubuikeAlex%2FCountryRegionJS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ogubuikeAlex","download_url":"https://codeload.github.com/ogubuikeAlex/CountryRegionJS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235294089,"owners_count":18966685,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","countries","countries-api","country","country-dropdownlist","country-state-city-dropdown","dropdown","javascript","location","nodejs","react","reactjs"],"created_at":"2025-01-23T14:20:00.229Z","updated_at":"2025-10-04T18:32:28.479Z","avatar_url":"https://github.com/ogubuikeAlex.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![CountryRegion A cascading dropdown for loading countries and associated states and local governments.](https://raw.githubusercontent.com/Slimcent/CountryRegion/master/images/CountryRegion.png)\n\n# **CountryRegion**\nCountryRegionJs is a simple-to-use library that provides you with **the MOST COMPREHENSIVE** cascading dropdown for loading countries, associated states and substates (local governments).\n\n![image](https://github.com/king-Alex-d-great/CountryRegionJS/assets/58665121/502b3627-e828-4871-8a9e-92f17f4ff6b5)\n\n\n## **Badges**\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\n\nstable release version: ![version](https://img.shields.io/badge/version-1.1.4-blue)\n\nNuget package downloads: ![downloads](https://img.shields.io/badge/downloads-~5k-yellow)\n\nNPM downloads: ![downloads](https://img.shields.io/badge/downloads-400+-brightgreen)\n\n## **Tech Stack**\nVanilla Javascript, Jest, Axios\n\n## **How Do I Get Started**\n\nInstall `CountryRegionJS` with npm\n\n```bash\n  npm install CountryRegionJS\n```\nor with yarn\n\n```javascript   \n   yarn add CountryRegionJS\n```\n\nSample usage:\n```javascript \n\n   //import countryregionjs\n   import CountryRegion from \"countryregionjs\";\n\n   const countryRegion = new CountryRegion();\n\n    //sample ids\n   const countryId = 1;\n   const stateId = 1;\n   const substateId = 1;\n\n   //get all countries\n   const countries = await countryRegion.getCountries();\n\n   //get all statess\n   const states = await countryRegion.getStates(countryId);\n\n   //get all substates\n   const subStates = await countryRegion.getLGAs(countryId, stateId);  \n\n   //get a country   \n   const country = await countryRegion.getCountry(countryId);\n\n   //get a state\n   const id = 1;\n   const country = await countryRegion.getState(countryId, stateId);\n\n   //get a sub-state\n   const id = 1;\n   const country = await countryRegion.getLga(countryId, stateId, substateId);\n```\n\n## **Documentation**\nA comprehensive documentation is underway💥\n\n## **Features**\n- Get all countries\n- Get all states\n- Get all local governments\n- Get a country\n- Get a state\n- Get a local government\n\n\n## **Testing**\nTo run unit tests:\n\n```shell\nnpm test\n```\n\n## **License**\n\n[MIT](LICENSE) Copyright 2023 OGUBUIKE ALEX\n\n## **Contributing**\n\nContributions are always welcome!\n\nSee `contributing.md` for ways to get started\n\n## **Code Of Conduct**\nPlease adhere to this project's \n[Code of Conduct](code_of_conduct.md) .\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FogubuikeAlex%2FCountryRegionJS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FogubuikeAlex%2FCountryRegionJS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FogubuikeAlex%2FCountryRegionJS/lists"}