RepoFinder

RepoFinder é uma aplicação minimalista e responsiva para pesquisar repositórios de usuários no GitHub. Com um design elegante em modo escuro, a aplicação permite visualizar a lista de repositórios, total de repositórios e links diretos para o perfil do usuário no GitHub.

📋 Visão Geral

Esta aplicação full-stack foi desenvolvida utilizando Java, React e TypeScript, com integração à API do GitHub.

🚀 Tecnologias utilizadas: Java, Spring Boot, React, Vite, Tailwind CSS, TypeScript

🎨 Funcionalidades

• Campo de busca: Permite pesquisar usuários pelo nome de perfil no GitHub.
• Exibição de resultados: Mostra os repositórios, total de repositórios, nome do usuário e um link para o perfil no GitHub.
• Design responsivo: Layout ajustável para dispositivos móveis e desktops.
• Modo escuro: Experiência visual minimalista e moderna.

🛠️ Tecnologias

• React
• Vite
• TypeScript
• Tailwind CSS
• Java
• Spring Boot

🖥️ Demonstração

🚀 Links

Ambiente	URL
Local	http://localhost:3000
Local	http://localhost:8080/github/user/${username}

📦 Estrutura do Projeto

O projeto segue uma estrutura modular para fácil manutenção:

Front-end:

• components/: Componentes reutilizáveis da interface.
• pages/: Páginas da aplicação.

Back-end:

• client/: Arquivos de configuração dos clients da api.
• config/: Arquivo de configuração do CORS da api.
• services/: Integração com a API do GitHub.
• controller/: Arquivo de configuração das rotas da api.
• model/: Arquivos de definição das respostas das rotas da api.

✅ Requisitos

Antes de começar, certifique-se de ter essas tecnologias instaladas:

• Git (link para download)
• Node.js (link para download)
• JDK (link para download)

📌 Como iniciar

1. Clone o repositório e entre no pasta do projeto:

   git clone https://github.com/eugfl/repofinder.git
   cd repoofinder

2. Entre na pasta do back-end e abra com seu editor de código:

   cd backend
   code .

3. Instale as dependências necessárias para o projeto funcionar:

   mvn clean install
   

4. Execute o servidor da api:

   ./mvnw spring-boot:run
   

5. Abra outro shell e entre na pasta do front-end:

   cd frontend
   

6. Instale as dependências necessárias para o projeto funcionar:

   pnpm install
   

7. Execute a aplicação:

   pnpm run dev
   

8. Abra no seu navegador e utilize:

   http://localhost:3000
   

🔍 Exemplo de Busca na API

Endpoint:

GET http://localhost:8080/github/user/${username}

Resposta:

{
  "login": "eugfl",
  "htmlUrl": "https://github.com/eugfl",
  "repositories": [
    {
      "name": "repofinder",
      "description": null,
      "private": false,
      "html_url": "https://github.com/eugfl/repofinder"
    }
  ]
}

🤝 Colaborador

Gabriel Figueiredo de Lima