{"id":21246867,"url":"https://github.com/apfirebolt/countries-and-states-database-app-in-react","last_synced_at":"2026-05-16T23:09:00.858Z","repository":{"id":114818942,"uuid":"530810921","full_name":"Apfirebolt/countries-and-states-database-app-in-React","owner":"Apfirebolt","description":"An app which displays countries, cities and states from around the world through an API","archived":false,"fork":false,"pushed_at":"2025-03-29T12:35:24.000Z","size":2023,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-29T13:31:58.341Z","etag":null,"topics":["cities-data","countries-api","flowbite","flowbite-ui","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/Apfirebolt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"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":"2022-08-30T20:00:23.000Z","updated_at":"2025-03-29T12:35:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"4a1c0354-d796-4543-9ef9-93e7a0ba09de","html_url":"https://github.com/Apfirebolt/countries-and-states-database-app-in-React","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Apfirebolt/countries-and-states-database-app-in-React","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apfirebolt%2Fcountries-and-states-database-app-in-React","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apfirebolt%2Fcountries-and-states-database-app-in-React/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apfirebolt%2Fcountries-and-states-database-app-in-React/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apfirebolt%2Fcountries-and-states-database-app-in-React/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Apfirebolt","download_url":"https://codeload.github.com/Apfirebolt/countries-and-states-database-app-in-React/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apfirebolt%2Fcountries-and-states-database-app-in-React/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33121861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T18:38:32.183Z","status":"ssl_error","status_checked_at":"2026-05-16T18:38:29.903Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cities-data","countries-api","flowbite","flowbite-ui","react","reactjs"],"created_at":"2024-11-21T02:08:22.594Z","updated_at":"2026-05-16T23:09:00.827Z","avatar_url":"https://github.com/Apfirebolt.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Flowbite Countries - Database for countries, cities and states \n\n![Countries_Logo](screenshots/countries.png)\n\n### Tech Stack\n\n![TailwindCSS](https://img.shields.io/badge/tailwindcss-%2338B2AC.svg?style=for-the-badge\u0026logo=tailwind-css\u0026logoColor=white)\n![React](https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge\u0026logo=react\u0026logoColor=%2361DAFB)\n![HTML5](https://img.shields.io/badge/html5-%23E34F26.svg?style=for-the-badge\u0026logo=html5\u0026logoColor=white)\n![CSS3](https://img.shields.io/badge/css3-%231572B6.svg?style=for-the-badge\u0026logo=css3\u0026logoColor=white)\n\n`Flowbite Countries` displays a huge list of states and cities from different countries around the world.\n\n**Features**\n\n- Huge database from the API provides data for 220+ countries, 70000 + cities and 5000 + states\n- Flowbite UI is used for attractive loaders, navbars and more.\n- Tailwind CSS is used for utility classes within the app.\n- Search filtering added.\n\n**Installation Options**\n---\n\nJust like you install majority of the Node powered front-end apps, three magic commands for you to run the app.\n\n1. Install with npm\n    + `$ npm install`\n    + `$ npm start`\n    + `$ npm build`\n\n2. Install through Docker\n    + `$ sudo docker build . --tag=react-countries`\n    + `$ sudo docker run -d -p 80:80 react-countries`\n\n\n**Updates**\n\n- 23rd December 2024 :- Added feature to show weather by implementing weather API.\n\n**Screenshots**\n---\n\nCountry List page which displays all countries\n\n![Country_List](screenshots/countries.png)\n\nCountry detail page which displays all the states of the given country.\n\n![Countries_Logo](screenshots/states.png)\n\nState detail page for a given state and country would display all the cities located in the state and available in the database.\n\n![States_Logo](screenshots/cities.png)\n\n1. Get API Key\n\n    + Go to this website - https://countrystatecity.in/\n        - Request for an API key, you should have it in your mail in around 2 days.\n    + Read the docs\n        - Read the docs to get the grasp of API end-points and response received.\n    + Use it in your app\n        - Use it in your app through the env file. Append this in request headers while making API calls.\n\n**How to Contribute**\n---\n\n1. Clone repo and create a new branch: `$ git checkout https://github.com/Apfirebolt/countries-and-states-database-app-in-React -b name_for_new_branch`.\n2. Make changes and test\n3. Submit Pull Request with comprehensive description of changes\n\n**Time Taken**\n---\n\nThe project took around 3 and half hours to complete from designing to analyzing API docs, creating UI and integrating APIs.\n\n**Acknowledgements**\n---\n\n+ [Darshan Gada](https://github.com/dr5hn) for creating and maintaining this awesome API.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapfirebolt%2Fcountries-and-states-database-app-in-react","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapfirebolt%2Fcountries-and-states-database-app-in-react","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapfirebolt%2Fcountries-and-states-database-app-in-react/lists"}