Company Handle Frontend 🏢💼

Este é o código-fonte de um aplicativo de frontend para listar empresas, feito com Vite-React, Typescript, Tailwind CSS e Material-UI.

Como usar 🚀

Pré-requisitos:

  • Ter Node.js instalado na versão v18.16.* ou superior.
  • Ter pnpm instalado para usar as dependências.

Siga as etapas abaixo para executar o aplicativo em seu ambiente local:

  1. Clonar o repositório:
git clone https://github.com/kelwinv/company-handle-frontend.git
cd company-handle-frontend
  1. Instalar as dependências (utilizando pnpm):
pnpm install
  1. Configurar a URL do servidor 🛠️

No arquivo .env, defina a URL do servidor backend. O valor da chave é VITE_SERVER_URL, mas como estamos usando Vite, é necessário adicionar o prefixo "vite". O valor deve ser configurado como:

VITE_SERVER_URL=http://localhost:3333

Certifique-se de que o servidor backend esteja em execução na URL configurada. Você pode encontrar o código do servidor backend em company-crud-with-tdd-backend.

  1. Executar o aplicativo 🏃‍♂️
pnpm dev

O aplicativo será executado localmente em http://localhost:3000.

Funcionalidades ✨

  • Listar empresas com paginação.
  • Filtrar empresas por nome.
  • Ordenar empresas por ID, CNAE, CNPJ, Nome da Empresa ou Nome Fantasia.
  • Escolher a direção da ordenação (ascendente ou descendente).

Tecnologias utilizadas 🛠️

  • Vite - Build tool para desenvolvimento rápido de aplicativos web.
  • Tailwind CSS - Biblioteca de classes utilitárias CSS para estilização.
  • Material-UI - Biblioteca de componentes React com material design.
  • React - Biblioteca para interface web.
  • Typescript - JavaScript com tipagem.
  • axios - Biblioteca usada para fazer conexão com a API.

Contribuindo 🤝

Se você encontrar problemas ou tiver sugestões de melhorias, fique à vontade para abrir uma "issue" neste repositório. Contribuições são sempre bem-vindas! 🙌

Licença 📄

Este projeto está licenciado sob a licença MIT. Sinta-se à vontade para usá-lo, modificar ou distribuir conforme a necessidade. Consulte o arquivo LICENSE para obter mais detalhes.

Espero que isso ajude! Se você tiver mais alguma dúvida ou precisar de mais informações, sinta-se à vontade para perguntar. Bom trabalho! 👍