Debug Library é uma aplicação fullstack desenvolvida com foco em produtividade, organização e colaboração para desenvolvedores(as). A plataforma permite cadastrar, fazer login e adicionar livros na lista personalizada com base em suas avaliações.
- Vite – Build tool ultra rápido.
- React – Biblioteca JavaScript para interfaces modernas.
- Typescript - Superset de JavaScript tipado.
- TailwindCSS – Framework utilitário de CSS.
- Banco de Dados: PostgreSQL
Adotamos o modelo de Gitflow para garantir uma organização eficiente e colaborativa no desenvolvimento.
-
main – Contém a versão estável e pronta para produção.
-
develop – Branch de desenvolvimento contínuo. Todas as features são integradas aqui antes de ir para produção.
-
feature/ – Para desenvolver novas funcionalidades.
-
fix/ – Correções de bugs identificados.
-
hotfix/ – Correções urgentes diretamente na produção.
-
release/<versão> – Preparação para uma nova versão de release.
⚠️ Importante:
Não se esqueça de criar a branchdeveloplocalmente em sua máquina para poder seguir com o fluxo do Gitflow:
git checkout -b develop origin/develop
- Criar uma nova funcionalidade:
git checkout developgit pullgit checkout -b feature/cadastro-snippets
Faça os commits normalmente e, ao finalizar:
git push origin feature/cadastro-snippets
Abra um Pull Request da sua branch para develop.
- Corrigir um bug:
git checkout developgit checkout -b fix/snippets-carregamento
- Lançar uma nova versão: Após aprovação e merge de features na develop:
git checkout -b release/v1.0.0
Realize os testes finais e abra um PR para main.
Sempre crie uma branch a partir de develop.
Commits devem ser claros e descritivos. Exemplo:
- feat: adiciona formulário de criação de snippet
- fix: corrige bug ao carregar biblioteca salva
Abra Pull Requests com descrições completas e solicite revisão.
Revise e teste sua funcionalidade antes de submeter.
Siga os passos abaixo para clonar e rodar o projeto localmente:
- Clone o repositório
git clone http://github.com/seu-usuario/debug-library-frontend.git
- Acesse a pasta do projeto
cd debug-library
- Instale as dependências
npm install
- Inicie o servidor de desenvolvimento
npm run dev
- Acesse no navegador
Abra o navegador e vá até:
http://localhost:5173
O Vite, por padrão, utiliza a porta 5173. Se estiver diferente, o terminal mostrará a porta correta após rodar npm run dev