IBGE Cities Statistics

This project is a straightforward exploration of the Brazilian IBGE API, designed to help (us) understand how it works. It was originally created by my friend Alcides as a Python API that interacts with the IBGE API for a job challenge. I decided to build on his work by using his API to develop this simple yet functional React web app 😄.

This web app lets you search for cities in the state of Ceará and view data such as population, literacy rates, and GDP trends over the years, as available from the IBGE API.

Installation and Setup

To run this project locally, follow these steps:

1. Clone the API repository and run it:

Clone the original Python API made by Alcides, and run it using Docker.

git clone https://github.com/srcid/insight-python

cd insight-python

docker compose up

2. Clone this repository and run it:

Clone this React webapp, install the dependencies and start the development server.

git clone https://github.com/carlosferreirahd/ibge-ce-cities-statistics-webapp.git

cd ibge-ce-cities-statistics-webapp

npm install

npm run dev

3. Check the application:

Open your browser and go to http://localhost:5173 to see the application running.

Technologies Used

• React;
• TypeScript;
• Vite;
• Tailwind CSS;
• tailwind-animated;
• daisyUI;
• fuse.js;
• Chart.js;
• TanStack Query;

Features

• List and Search Ceará Cities;
• Population Growth Graph over the years;
• Literacy Rates Graph over the years;
• GDP Trends Graph over the years;
• Light and Dark Themes;